Hoppa till huvudinnehållet

Dina kontoinställningar

Dina personliga inställningar finns under din avatar → Inställningar (frem.sh/user/settings). De hör till ditt konto, separat från organisationernas administration, och följer med dig till alla organisationer du är medlem i. Den här sidan beskriver det du själv hanterar: nycklar, token och aviseringar.

SSH-nycklar

Om din organisation tillåter SSH (det är avstängt som standard för nya organisationer; se När SSH inte är tillåtet nedan) registrerar du dina publika nycklar här.

Lägg till en nyckel: öppna Inställningar → SSH/GPG-nycklar, klistra in din publika nyckel (innehållet i ~/.ssh/id_ed25519.pub), ge den ett namn du känner igen och spara. fremforge visar nyckelns fingeravtryck och när den senast användes för autentisering, så att du kan upptäcka en nyckel du inte längre känner igen.

Återkalla en nyckel: radera den på samma sida. Återkallelsen gäller omedelbart: nästa Git-operation med den nyckeln avvisas. Återkalla genast varje nyckel som finns på en borttappad eller avvecklad enhet.

Använd helst hårdvarubaserade nycklar (sk-*-algoritmer: Touch ID, FIDO/YubiKey). Vissa organisationer kräver dem, och då avvisas en nyckel som inte är hårdvarubaserad redan vid registreringen. Se Säker inloggning för hela genomgången av hur du skapar nycklar.

GPG-nycklar

Registrera en publik GPG-nyckel här så att dina signerade commits och taggar visas som Verified i gränssnittet.

Lägg till en nyckel: öppna Inställningar → SSH/GPG-nycklar, klistra in din ASCII-armerade publika nyckel (gpg --armor --export <key-id>) och spara. fremforge kontrollerar att nyckelns mejladress stämmer med en verifierad mejladress på ditt konto innan commits markeras som verifierade.

Återkalla en nyckel: radera den på samma sida. Commits som redan har signerats med den behåller sin historiska signatur; nya commits som signeras med den raderade nyckeln visas inte längre som verifierade.

Vill du helst slippa hantera långlivade signeringsnycklar stöder fremforge nyckelfri, identitetsbaserad signering av commits via din IdP: ingen nyckel att skapa, förvara eller rotera. Se Nyckelfri signering av commits.

Personliga åtkomsttoken (PAT)

En personlig åtkomsttoken autentiserar Git-operationer och API-anrop som dig, utan interaktiv inloggning i webbläsaren. Det är praktiskt för skript, lokala verktyg och alla klienter som inte kan köra GCM:s webbläsarflöde.

Skapa en token: öppna Inställningar → Git-åtkomsttoken → Skapa ett nytt PAT, ge den ett beskrivande namn, välj scopes (ge bara det som användningsfallet behöver), ange ett utgångsdatum och klicka på Skapa PAT. Tokenvärdet visas en enda gång: kopiera det direkt, du kan inte hämta det senare.

Använd en PAT som lösenord för Git-operationer över HTTPS, eller som bearer-token mot REST API:t:

# 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

Återkalla en token: klicka på Återkalla bredvid den på samma sida. Återkallelsen gäller omedelbart. Återkalla varje token som kan ha läckt, och välj korta giltighetstider så att en bortglömd token slutar gälla av sig själv. Din organisation kan ha satt ett tak för hur länge en token får gälla; avvisas ditt valda utgångsdatum är det taket som är orsaken.

För vardagligt Git-arbete är interaktiv HTTPS + Git Credential Manager (med MFA vid varje förnyelse) den rekommenderade vägen framför en långlivad PAT. Se Säker inloggning.

Aviseringsinställningar

Öppna Inställningar → Konto för att styra hur fremforge når dig. Inställningen för mejlaviseringar under Hantera e-postadresser (sparas med Ställ in e-postpreferenser) avgör om du får mejl om händelser du prenumererar på (issues och PR:ar som du är tilldelad, omnämnanden, granskningar som du ombeds göra och repon som du bevakar). Stäng av det för att bara använda inkorgen för aviseringar i appen, eller låt det vara på för att även få mejl. Bevakningsinställningarna per repo (kontrollen Watch i varje repo) avgör vilka repon som över huvud taget ger upphov till aviseringarna.

När SSH inte är tillåtet

Nya organisationer levereras med SSH-inloggning avstängd; HTTPS är standardvägen för Git. Om alla organisationer du tillhör har SSH avstängt talar avsnittet SSH keys i dina inställningar om det: du ser läget ”SSH not permitted” i stället för formuläret för att lägga till nycklar, eftersom en nyckel just nu inte skulle kunna användas någonstans.

Försöker du ändå avvisas clone, fetch och push över SSH mot den organisationens repon, med ett meddelande som namnger organisationsinställningen och anger HTTPS-URL:en att klona via i stället.

Så här gör du:

  • Använd HTTPS i stället. Klona och pusha över https://frem.sh/<org>/<repo>.git med Git Credential Manager. Det är ändå den rekommenderade vägen, och den kräver MFA vid varje förnyelse av token. Se Säker inloggning för konfigurationen.
  • För icke-interaktiva klienter: skapa en personlig åtkomsttoken och använd den som lösenord över HTTPS.
  • Om du verkligen behöver SSH: be en ägare av organisationen att slå på SSH-protokollet igen för organisationen (Organisationens administration → Autentiseringspolicy). Så snart någon organisation du tillhör tillåter SSH visas formuläret för att lägga till nycklar här igen.

Korsreferenser