Hoppa till huvudinnehållet

Ansluta till fremforge

De flesta fremforge-organisationer har som standard bara Git-åtkomst över HTTPS (SSH är avstängt i organisationens policy sedan 2026-05-22); se guiden för säker inloggning för den rekommenderade konfigurationen med HTTPS + Git Credential Manager. Sidan nedan gäller när organisationens administratör uttryckligen har slagit på SSH igen under <your-org>/_admin/auth-policy/. SSH-vägen finns kvar; den är bara inte längre standard.

Innan du pushar kod eller hämtar repon över SSH ber din SSH-klient dig att bekräfta serverns identitet. Avsnitten nedan beskriver vad du ska kontrollera och hur du konfigurerar SSH för nätverk som blockerar port 22.

Lägg till en SSH-nyckel

Skapa en nyckel på din egen dator och ge fremforge den publika halvan:

ssh-keygen -t ed25519 -C "you@example.com"
cat ~/.ssh/id_ed25519.pub

Klistra in raden som börjar med ssh-ed25519 under Inställningar → SSH/GPG-nycklar och välj Lägg till nyckel. Om din organisation har SSH avstängt avvisas Git över SSH oavsett vilken nyckel du lägger till; använd i stället HTTPS med en Git-åtkomsttoken.

Verifiera värdnyckeln

Vid första anslutningen ber SSH-klienten dig att bekräfta fingeravtrycket för serverns värdnyckel. Innan du godkänner, kontrollera att fingeravtrycket stämmer med värdena som publiceras på frem.sh/ssh-fingerprints.

Godkänn aldrig ett fingeravtryck som inte finns på den sidan.

Verifiering vid första anslutningen

Port 22 är inte exponerad. fremforge tillhandahåller SSH på port 443 via värdnamnet ssh.frem.sh; se värdaliaset nedan för den kanoniska konfigurationen i ~/.ssh/config, som du gör en gång och som låter dig fortsätta skriva git@frem.sh i dina git-remotes.

  1. Kör autentiseringstestet (fungerar utan någon ändring i ~/.ssh/config):
ssh -T -p 443 git@ssh.frem.sh
  1. Terminalen visar något i stil med:
The authenticity of host '[ssh.frem.sh]:443 ([203.0.113.10]:443)' can't be established.
ED25519 key fingerprint is SHA256:AAAA....
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])?

  1. Jämför fingeravtrycket som visas med de publicerade värdena på https://www.frem.sh/ssh-fingerprints/. Om de stämmer, skriv yes.

  2. SSH skriver den godkända nyckeln till ~/.ssh/known_hosts. Vid alla senare anslutningar verifieras den tyst. Inga fler frågor om inte nyckeln ändras.

  3. När det lyckas ser du:

Hi <username>! You've successfully authenticated, but fremforge does not provide shell access.

Om du i stället ser Permission denied (publickey) har din nyckel inte lagts till på kontot, eller så erbjuds fel nyckel. Se Kom igång för konfiguration av nycklar.

Kontrollera known_hosts manuellt

Så ser du vilken nyckel SSH har sparat för ssh.frem.sh:

ssh-keygen -F '[ssh.frem.sh]:443'

Så tar du bort en sparad nyckel (till exempel om servernyckeln legitimt har roterats och du har fått besked om det):

ssh-keygen -R '[ssh.frem.sh]:443'

Anslut sedan igen och kontrollera det nya fingeravtrycket mot https://www.frem.sh/ssh-fingerprints/ innan du godkänner.

SSH på port 443 (krävs, port 22 är inte exponerad)

fremforge exponerar inte port 22 på frem.sh. SSH tillhandahålls på port 443 via värdnamnet ssh.frem.sh: samma SSH-protokoll på en port som brandväggar normalt håller öppen för HTTPS. Det här är den enda SSH-vägen, ingen reservväg.

Konfigurera SSH-klienten att använda den när du skriver frem.sh i en git-remote:

# ~/.ssh/config
Host frem.sh
    Hostname ssh.frem.sh
    Port 443

Med det på plats använder git clone git@frem.sh:<org>/<repo>.git och alla andra Git-operationer mot frem.sh port 443 automatiskt. Inga ändringar av remote-URL:er behövs.

Testa anslutningen direkt innan du förlitar dig på den:

ssh -T -p 443 git@ssh.frem.sh
# Hi <username>! You've successfully authenticated, but fremforge does not provide shell access.

Samma fingeravtryck för värdnycklarna gäller på port 443. Kontrollera dem mot https://www.frem.sh/ssh-fingerprints/ vid första användningen.

HTTPS med en Git-åtkomsttoken

Om SSH inte är tillgängligt alls, klona och pusha över HTTPS:

git clone https://frem.sh/<org>/<repo>.git

Git frågar efter användarnamn och lösenord. Ditt kontolösenord fungerar inte här: ange ditt fremforge-användarnamn och en Git-åtkomsttoken som lösenord. Om Git svarar ”Credentials are incorrect or have expired” är det nästan alltid orsaken.

Skapa token under Inställningar → Git-åtkomsttoken. Samma sida visar Ställ in OAuth för Git över HTTPS (en gång): kör den en gång, så använder Git din fremforge-inloggning (SSO) i stället för en token. Organisationens administratör bestämmer om personliga token är tillåtna, vilka scopes du kan välja och hur länge de gäller; om token är avstängda för din organisation, använd OAuth-konfigurationen.

För att slippa upprepade frågor kan du spara uppgiften i gits hjälpprogram för inloggningsuppgifter:

git config --global credential.helper osxkeychain   # macOS
git config --global credential.helper manager        # Windows (Git Credential Manager)
git config --global credential.helper store          # Linux (plaintext — use only on trusted machines)

HTTPS över port 443 är alltid tillgängligt, oavsett port 22 eller reservvägen via ssh.frem.sh. Det är den anslutningsmetod som fungerar i flest miljöer.

Korsreferenser