Gå til hovedinnhold

Kontoinnstillingene dine

De personlige innstillingene dine finner du under avataren din → Innstillinger (frem.sh/user/settings). De hører til din konto, atskilt fra administrasjonsflaten til enhver organisasjon, og følger deg i alle organisasjoner du er medlem av. Denne siden dekker det du administrerer selv: nøkler, tokener og varsler.

SSH-nøkler

Hvis organisasjonen din tillater SSH (det er slått av som standard i nye organisasjoner; se Når SSH ikke er tillatt nedenfor), registrerer du de offentlige nøklene dine her.

Slik legger du til en nøkkel: åpne Innstillinger → SSH- / GPG-nøkler, lim inn den offentlige nøkkelen din (innholdet i ~/.ssh/id_ed25519.pub), gi den et navn du kjenner igjen, og lagre. fremforge viser nøkkelens fingeravtrykk og datoen den sist ble brukt til autentisering, slik at du kan oppdage en nøkkel du ikke lenger kjenner igjen.

Slik tilbakekaller du en nøkkel: slett den på samme side. Tilbakekallingen gjelder umiddelbart: neste Git-operasjon med den nøkkelen blir avvist. Tilbakekall med en gang enhver nøkkel som ligger på en enhet som er mistet eller tatt ut av bruk.

Foretrekk maskinvarebaserte nøkler (sk-*-algoritmer: Touch ID, FIDO/YubiKey). Noen organisasjoner krever dem, og da blir en nøkkel som ikke er maskinvarebasert, avvist ved registrering. Se Sikker innlogging for en fullstendig gjennomgang av hvordan du genererer nøkler.

GPG-nøkler

Registrer en offentlig GPG-nøkkel her for at signerte commits og tagger skal vises som Bekreftet i grensesnittet.

Slik legger du til en nøkkel: åpne Innstillinger → SSH- / GPG-nøkler, lim inn den ASCII-armerte offentlige nøkkelen din (gpg --armor --export <key-id>), og lagre. fremforge kontrollerer at e-postadressen i nøkkelen samsvarer med en bekreftet e-postadresse på kontoen din før commits markeres som bekreftet.

Slik tilbakekaller du en nøkkel: slett den på samme side. Commits som allerede er signert med den, beholder den historiske signaturen sin; nye commits signert med den slettede nøkkelen vises ikke lenger som bekreftet.

Hvis du helst slipper å administrere langlivede signeringsnøkler, støtter fremforge nøkkelfri, identitetsbasert commit-signering via IdP-en din: ingen nøkkel å generere, lagre eller rotere. Se Nøkkelfri commit-signering.

Personlige tilgangstokener (PAT-er)

Et personlig tilgangstoken autentiserer Git-operasjoner og API-kall som deg, uten interaktiv innlogging i nettleseren. Det er nyttig for skript, lokale verktøy og alle klienter som ikke kan kjøre GCM-flyten i nettleseren.

Slik oppretter du et token: åpne Innstillinger → Git-tilgangstokener → Lag en ny PAT, gi tokenet et beskrivende navn, velg scopes (gi bare det bruksområdet trenger), angi en utløpstid og klikk Lag PAT. Tokenverdien vises bare én gang: kopier den med en gang, for du kan ikke hente den fram igjen senere.

Bruk et PAT som passord for Git-operasjoner over HTTPS, eller som bearer-token mot 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

Slik tilbakekaller du et token: klikk Tilbakekall ved siden av det på samme side. Tilbakekallingen gjelder umiddelbart. Tilbakekall alle tokener som kan ha lekket, og velg korte utløpstider, slik at et glemt token utløper av seg selv. Organisasjonen din kan ha satt en øvre grense for hvor lenge et token kan leve; blir utløpstiden du velger, avvist, er det grensen som er årsaken.

Til daglig Git-bruk for mennesker anbefales interaktiv HTTPS + Git Credential Manager (med MFA ved hver fornyelse) framfor et langlivet PAT. Se Sikker innlogging.

Varslingsinnstillinger

Åpne Innstillinger → Konto for å styre hvordan fremforge når deg. Innstillingen for e-postvarsler under Administrer e-postadresser (lagres med Angi e-postinnstilling) avgjør om du får e-post om hendelser du abonnerer på (issues og pull requests du er tildelt, omtaler, gjennomganger du er bedt om, og repositoryer du følger). Slå den av for å bare bruke varslingsinnboksen i appen, eller la den være på for å få e-post i tillegg. Innstillingene for å følge hvert enkelt repository (kontrollen Følg på hvert repo) avgjør hvilke repositoryer som i det hele tatt sender varsler hit.

Når SSH ikke er tillatt

Nye organisasjoner leveres med SSH-innlogging slått av; HTTPS er standardveien for Git. Hvis alle organisasjonene du er medlem av, har slått av SSH, sier delen SSH-nøkler i innstillingene fra om det: du ser tilstanden «SSH not permitted» i stedet for skjemaet for å legge til nøkler, fordi det ikke finnes noe sted en nøkkel kan brukes akkurat nå.

Prøver du likevel, blir clone, fetch eller push over SSH mot den organisasjonens repositoryer avvist med en melding som nevner innstillingen i organisasjonen og gir deg HTTPS-URL-en du kan klone med i stedet.

Hva du kan gjøre:

  • Bruk HTTPS i stedet. Klon og push over https://frem.sh/<org>/<repo>.git med Git Credential Manager. Dette er uansett den anbefalte veien, og den gir MFA ved hver fornyelse av tokenet. Se Sikker innlogging for oppsett.
  • For klienter som ikke er interaktive, oppretter du et personlig tilgangstoken og bruker det som HTTPS-passord.
  • Hvis du virkelig trenger SSH, ber du en eier av organisasjonen om å slå på SSH-protokollen igjen for organisasjonen (Organisasjonsadministrasjon → Autentiseringspolicy). Så snart én av organisasjonene du er medlem av, tillater SSH, dukker skjemaet for å legge til nøkler opp her igjen.

Se også