Gå til hovedindhold

Dine kontoindstillinger

Dine personlige indstillinger finder du under din avatar → Indstillinger (frem.sh/user/settings). De hører til din konto og er adskilt fra en organisations administrationsflade – de følger med dig på tværs af alle de organisationer, du er medlem af. Denne side dækker de områder, du selv administrerer: nøgler, tokens og notifikationer.

SSH-nøgler

Tillader din organisation SSH (det er slået fra som standard i nye organisationer, se Når SSH ikke er tilladt nedenfor), registrerer du dine offentlige nøgler her.

Sådan tilføjer du en nøgle: åbn Indstillinger → SSH / GPG nøgler, indsæt din offentlige nøgle (indholdet af ~/.ssh/id_ed25519.pub), giv den et navn, du kan genkende, og gem. fremforge viser nøglens fingeraftryk og datoen for, hvornår den sidst blev brugt til at logge ind, så du kan opdage en nøgle, du ikke længere kender.

Sådan tilbagekalder du en nøgle: slet den på samme side. Tilbagekaldelsen sker med det samme – den næste Git-handling med den nøgle afvises. Tilbagekald straks enhver nøgle på en enhed, der er bortkommet eller taget ud af brug.

Foretræk hardwarebaserede nøgler (sk-*-algoritmer – Touch ID, FIDO/YubiKey). Nogle organisationer kræver dem, og så afvises en nøgle uden hardware allerede ved registreringen. Se Sikkert login for en komplet gennemgang af, hvordan du genererer nøgler.

GPG-nøgler

Registrér en offentlig GPG-nøgle her, så dine signerede commits og tags vises som Verified i brugerfladen.

Sådan tilføjer du en nøgle: åbn Indstillinger → SSH / GPG nøgler, indsæt din ASCII-armerede offentlige nøgle (gpg --armor --export <key-id>), og gem. fremforge kontrollerer, at nøglens e-mailadresse svarer til en bekræftet e-mailadresse på din konto, før den markerer commits som verificerede.

Sådan tilbagekalder du en nøgle: slet den på samme side. Commits, der allerede er signeret med den, beholder deres historiske signatur; nye commits signeret med den slettede nøgle vises ikke længere som verificerede.

Vil du helst slet ikke administrere langlivede signeringsnøgler, understøtter fremforge nøglefri, identitetsbaseret signering af commits gennem din IdP – ingen nøgle at generere, opbevare eller rotere. Se Nøglefri signering af commits.

Personlige adgangstokens (PAT’er)

Et personligt adgangstoken godkender Git-handlinger og API-kald som dig uden et interaktivt login i browseren – praktisk til scripts, lokale værktøjer og enhver klient, der ikke kan køre GCM’s browserflow.

Sådan opretter du et token: åbn Indstillinger → Git-adgangstokens → Opret en ny PAT, giv det et beskrivende navn, vælg dets scopes (giv kun det, brugsscenariet kræver), angiv en udløbsdato, og klik på Opret PAT. Tokenets værdi vises kun én gang – kopiér det med det samme; du kan ikke hente det igen senere.

Brug et PAT som adgangskode til Git-handlinger over HTTPS eller som bearer-token til REST API’et:

# Git over HTTPS
git clone https://frem.sh/<org>/<repo>.git
# username: your fremforge username; password: the PAT

# REST API
curl -H "Authorization: token <PAT>" https://frem.sh/_app/api/v1/user

Sådan tilbagekalder du et token: klik på Tilbagekald ud for det på samme side. Tilbagekaldelsen sker med det samme. Tilbagekald ethvert token, der kan være lækket, og foretræk korte udløbstider, så et glemt token selv udløber. Din organisation kan have sat en øvre grænse for, hvor længe et token må leve; afvises den udløbsdato, du har valgt, er det grænsen, der er årsagen.

Til daglig brug af Git som menneske anbefales interaktiv HTTPS + Git Credential Manager (med MFA ved hver fornyelse) frem for et langlivet PAT. Se Sikkert login.

Notifikationer

Åbn Indstillinger → Konto for at styre, hvordan fremforge når dig. Indstillingen for e-mailnotifikationer under Administrer e-mailadresser (gemmes med Indstil e-mail-præference) bestemmer, om du får en e-mail ved hændelser, du abonnerer på (issues og pull requests, du er tildelt, omtaler, reviews, du er blevet bedt om, og repositories, du følger). Slå den fra, hvis du kun vil bruge indbakken i appen, eller lad den være slået til for også at få e-mails. Indstillingerne for at følge det enkelte repository (knappen Watch på hvert repository) afgør, hvilke repositories der overhovedet sender notifikationer.

Når SSH ikke er tilladt

Nye organisationer leveres med login via SSH slået fra – HTTPS er standardvejen til Git. Har alle de organisationer, du er medlem af, slået SSH fra, fortæller afsnittet SSH keys i dine indstillinger dig det: I stedet for formularen til at tilføje en nøgle ser du beskeden SSH- og GPG-nøgler er ikke tilladt, fordi der i øjeblikket ikke er noget sted, hvor en nøgle kunne bruges.

Prøver du alligevel, afvises clone, fetch og push over SSH mod den organisations repositories med en besked, der nævner organisationens indstilling og giver dig HTTPS-URL’en, du kan clone fra i stedet.

Hvad du kan gøre:

  • Brug HTTPS i stedet. Clone og push over https://frem.sh/<org>/<repo>.git med Git Credential Manager – det er alligevel den anbefalede vej, og den giver MFA ved hver fornyelse af tokenet. Se Sikkert login for opsætningen.
  • Til klienter uden brugerinteraktion opretter du et personligt adgangstoken og bruger det som adgangskode over HTTPS.
  • Har du reelt brug for SSH, så bed en ejer af organisationen om at slå SSH-protokollen til igen for organisationen (Administration → Godkendelsespolitik). Så snart en af dine organisationer tillader SSH, kommer formularen til at tilføje nøgler tilbage her.

Krydsreferencer

  • Sikkert login: opsætning af HTTPS + GCM, vejen til at slå SSH til, og hardwarebaserede nøgler
  • Nøglefri signering af commits: identitetsbaseret signering uden en nøgle at administrere
  • API: brug et PAT som bearer-token mod REST API’et