Gå til hovedinnhold

Koble til fremforge

De fleste fremforge-organisasjoner har bare Git-tilgang over HTTPS som standard (SSH er slått av i organisasjonspolicyen siden 2026-05-22). Se veiledningen for sikker innlogging for det anbefalte oppsettet med HTTPS + Git Credential Manager. Siden nedenfor gjelder når administratoren i organisasjonen din uttrykkelig har slått på SSH igjen under <your-org>/_admin/auth-policy/. SSH-veien finnes fortsatt; den er bare ikke lenger standard.

Før du pusher kode eller puller repositoryer over SSH, ber SSH-klienten deg bekrefte serverens identitet. Delene nedenfor forklarer hva du skal kontrollere, og hvordan du konfigurerer SSH på nettverk som blokkerer port 22.

Legg til en SSH-nøkkel

Lag en nøkkel på din egen maskin, og gi fremforge den offentlige delen:

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

Lim inn linjen som begynner med ssh-ed25519, under Innstillinger → SSH- / GPG-nøkler, og velg Legg til nøkkel. Hvis organisasjonen din har slått av SSH, blir Git over SSH avvist uansett hvilken nøkkel du legger til; bruk da HTTPS med et Git-tilgangstoken i stedet.

Kontroller vertsnøkkelen

Ved første tilkobling ber SSH-klienten deg bekrefte fingeravtrykket til serverens vertsnøkkel. Før du godtar det, må du kontrollere at fingeravtrykket samsvarer med verdiene som er publisert på frem.sh/ssh-fingerprints.

Godta ikke et fingeravtrykk som ikke står på den siden.

Kontroll ved første tilkobling

Port 22 er ikke åpen. fremforge leverer SSH på port 443 via vertsnavnet ssh.frem.sh. Se Host-aliaset nedenfor for den kanoniske ~/.ssh/config-konfigurasjonen du setter opp én gang, slik at du kan fortsette å skrive git@frem.sh i git-remotene dine.

  1. Kjør autentiseringstesten (fungerer uten endringer i ~/.ssh/config):
ssh -T -p 443 git@ssh.frem.sh
  1. Terminalen din viser noe som ligner på dette:
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. Sammenlign fingeravtrykket som vises, med verdiene som er publisert på https://www.frem.sh/ssh-fingerprints/. Skriv yes hvis de samsvarer.

  2. SSH skriver den godtatte nøkkelen til ~/.ssh/known_hosts. Ved alle senere tilkoblinger kontrolleres den i det stille. Du blir ikke spurt igjen med mindre nøkkelen endres.

  3. Når det lykkes, ser du:

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

Ser du Permission denied (publickey) i stedet, er nøkkelen enten ikke lagt til på kontoen din, eller så blir feil nøkkel tilbudt. Se Kom i gang for oppsett av nøkler.

Kontroller known_hosts manuelt

Slik ser du hvilken nøkkel SSH har lagret for ssh.frem.sh:

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

Slik fjerner du en lagret nøkkel (for eksempel hvis servernøkkelen faktisk er rotert og du har fått beskjed om det):

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

Koble deretter til på nytt, og kontroller det nye fingeravtrykket mot https://www.frem.sh/ssh-fingerprints/ før du godtar det.

SSH på port 443 (påkrevd, port 22 er ikke åpen)

fremforge åpner ikke port 22 på frem.sh. SSH leveres på port 443 via vertsnavnet ssh.frem.sh: den samme SSH-protokollen på en port som brannmurer vanligvis lar være åpen for HTTPS. Dette er den eneste SSH-veien, ikke en reserveløsning.

Konfigurer SSH-klienten din til å bruke den hver gang du skriver frem.sh i en git-remote:

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

Med dette på plass bruker git clone git@frem.sh:<org>/<repo>.git og alle andre Git-operasjoner mot frem.sh port 443 automatisk. Du trenger ikke endre noen remote-URL-er.

Test tilkoblingen direkte før du stoler på den:

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

De samme fingeravtrykkene for vertsnøkler gjelder på port 443. Kontroller dem mot https://www.frem.sh/ssh-fingerprints/ første gang du bruker den.

HTTPS med et Git-tilgangstoken

Hvis SSH ikke er tilgjengelig i det hele tatt, kloner og pusher du over HTTPS:

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

Git ber om brukernavn og passord. Kontopassordet ditt fungerer ikke her: skriv inn fremforge-brukernavnet ditt og et Git-tilgangstoken som passord. Hvis Git svarer «Credentials are incorrect or have expired», er det nesten alltid dette som er årsaken.

Opprett tokenet under Innstillinger → Git-tilgangstokener. Den samme siden viser et engangsoppsett, Sett opp OAuth for Git over HTTPS: kjør det én gang, så bruker Git fremforge-innloggingen din (SSO) i stedet for et token. Administratoren i organisasjonen din bestemmer om personlige tokener er tillatt, hvilke scopes du kan velge og hvor lenge de lever. Hvis tokener er slått av for organisasjonen din, bruker du OAuth-oppsettet.

For å slippe gjentatte spørsmål kan du lagre legitimasjonen i Gits credential helper:

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 over port 443 er alltid tilgjengelig, uavhengig av port 22 eller reserveløsningen ssh.frem.sh. Det er den tilkoblingsmåten som fungerer flest steder.

Se også