SSH-agent

Bitwarden Password Manager desktop applicatie kan fungeren als een SSH Agent om uw SSH (Secure Shell) sleutels veilig te versleutelen en op te slaan voor gebruik met:

• Authenticeren op servers

• Ondertekenen van Git commits

• Interactie met SSH-gebaseerde diensten

De Bitwarden SSH Agent organiseert en beschermt uw sleutels op één veilige locatie. SSH-sleutels zijn toegankelijk via de desktop-app, web-app, browserextensie en mobiele app. SSH-sleutels kunnen worden gegenereerd met de desktop-app, web-app en browserextensie.

Nieuwe SSH-sleutels kunnen worden gemaakt en opgeslagen in de Bitwarden desktop-app. Bitwarden SSH-sleutels worden opgeslagen:

SSH-sleutels die zijn opgeslagen in de Bitwarden wachtwoordmanager hebben toegang tot Bitwarden-functies zoals mappen, favorieten, hoofdwachtwoordherhaling, notities, items klonen, bijlagen en aangepaste velden.

Maak een nieuwe SSH-sleutel aan met de Bitwarden desktop-app, web-app of browserextensie. Eenmaal aangemaakt zijn SSH-sleutels die zijn opgeslagen in Bitwarden toegankelijk vanuit de desktop-app, web-app, browser-extensie en mobiele apps.

1. Selecteer de knop Nieuw en kies SSH-sleutel als type item:

   

   note

   Op dit moment kan Bitwarden alleen SSH-sleutels van het type ED25519 genereren.

2. Vul de overige gegevens in zoals Naam en selecteer het pictogram Opslaan zodra u klaar bent.

SSH-sleutels kunnen worden aangemaakt en opgeslagen in een organisatieverzameling. Organisatieleden met de juiste machtigingen kunnen SSH-sleutels die eigendom zijn van een organisatie aanmaken, beheren en openen. Leer hier meer over collectierechten.

Om een nieuwe gedeelde SSH-sleutel toe te voegen aan de organisatiekluis:

1. In de Vault view van de desktop of web app, selecteer je de knop New en selecteer je SSH key.
   

   tip

   Organisatie-eigenaren, beheerders en sommige aangepaste gebruikers kunnen deze stap ook rechtstreeks vanuit de Admin Console uitvoeren om een aantal stappen in dit proces over te slaan.

2. Kies in het Eigenaar-keuzemenu de organisatie waarvan dit item eigendom moet zijn.

3. Kies in de vervolgkeuzelijst Verzamelingen de verzameling(en) waarmee u dit item wilt delen.

   

Zodra een SSH-sleutel is opgeslagen in uw Bitwarden-kluis, kunt u enkele sleutelvelden bewerken, zoals naam, eigenaar, map en aangepaste velden:

De importeerfunctie voor SSH-sleutels is beschikbaar op de Bitwarden desktop app. Gebruik de Bitwarden desktop-app:

1. Selecteer de knop Nieuw en kies SSH-sleutel als itemtype.

2. Kopieer de bestaande SSH-sleutel die u wilt importeren in Bitwarden.

3. Gebruik het pictogram Sleutel importeren van klembord. Hierdoor wordt de SSH-sleutel automatisch in Bitwarden geplakt.

   • Op dit moment moeten geïmporteerde sleutels in OpenSSH- of PKCS#8-indeling zijn.

     

Als u Bitwarden wilt gebruiken als uw primaire SSH-agent, moet u uw SSH-client configureren om te communiceren met Bitwarden voor verificatie.

Om de SSH-agent in te schakelen op uw Bitwarden-desktop-app, navigeert u naar Instellingen en SSH-agent inschakelen.

Nadat u SSH-agent hebt ingeschakeld, kunt u ook de instelling Vragen om autorisatie bij gebruik van SSH-agent aanpassen. Deze instelling bepaalt wanneer Bitwarden u vraagt om toestemming voor toegang tot een SSH-sleutel:

• Altijd

• Nooit

• Onthouden tot kluis is vergrendeld

Altijd is standaard geselecteerd.

Zodra de SSH-agent is geconfigureerd voor Bitwarden, kunnen we de installatie testen door een SSH-lijst op te vragen:

Plain TextCopy
ssh-add -L

Dit geeft een lijst met SSH-sleutels die zijn opgeslagen in uw Bitwarden-desktopclient.

SSH kan gebruikt worden om te authenticeren met Git. De Bitwarden SSH Agent kan veiligheid en gebruiksgemak toevoegen aan je Git workflows. In dit voorbeeld zal de Bitwarden SSH Agent authenticeren bij GitHub.

1. Op je GitHub account, stel je een SSH sleutel in door te navigeren naar Instellingen, SSH en GPG sleutels, en dan Nieuwe SSH sleutel te selecteren.
   

2. Op het nieuwe SSH sleutel toevoegen scherm, voeg een Naam toe, selecteer een Sleuteltype. Kies Authenticatiesleutel. Kopieer en plak de publieke sleutel van je Bitwarden kluis in het sleutelveld op GitHub.
   

   

3. Als je alle velden hebt ingevuld, selecteer je Add SSH key om de sleutel op te slaan. GitHub zal je vragen je GitHub account te verifiëren voordat de sleutel wordt opgeslagen.

4. Test de GitHub SSH sleutel in je terminal, bijvoorbeeld als je macOS gebruikt:
   

   Plain TextCopy
   ssh -T git@github.com

5. Als dit lukt, vraagt Bitwarden u om het verzoek om toegang te verifiëren. Selecteer Autoriseren om te bevestigen. Als het lukt, krijgt u een bericht waarin de authenticatiepoging wordt geverifieerd:
   

   Plain TextCopy
   Hi <USER>! You've successfully authenticated, but GitHub does not provide shell access.

De Bitwarden SSH Agent gebruiken om SSH Git commits te ondertekenen. Voordat je de Bitwarden SSH Agent kunt gebruiken om Git commits te ondertekenen, heeft je systeem het volgende nodig:

• Git versie 2.34 of nieuwer. Controleer je Git versie met:
  

  Plain TextCopy
  git --version

• OpenSSH versie 8.8 of nieuwer. Controleer de versie met:
  

  Plain TextCopy
  ssh -V

• Bitwarden desktop client met SSH Agent ingeschakeld.
  

Configureer je Git omgeving om naar je SSH sleutel te wijzen voor ondertekening. Om dit te doen kun je globale variabelen instellen of de instructies in je .gitconfig bestand vastleggen.

Globale variabelen instellen

Om Git instellingen te configureren met --globale variabelen:

1. Stel Git in om SSH te gebruiken voor het ondertekenen:
   

   Plain TextCopy
   git config --global gpg.format ssh

2. Specificeer de SSH sleutel om te gebruiken als de ondertekeningssleutel. Om de Bitwarden SSH Agent te gebruiken vervang je <YOUR_PUBLIC_KEY> door de publieke sleutel die gekopieerd is van de SSH sleutel die opgeslagen is in je Bitwarden kluis.
   

   Plain TextCopy
   git config --global user.signingkey "<YOUR_PUBLIC_KEY>"

3. Schakel automatisch vastleggen ondertekenen in.
   

   Plain TextCopy
   git config --global commit.gpgsign true

Instellen .gitconfig bestand

Om Git in te stellen met behulp van een .gitconfig bestand:

1. Open .gitconfig met je favoriete teksteditor:
   

   Plain TextCopy
   nano ~/.gitconfig

2. Voeg de volgende configuraties toe:
   

   BashCopy
   [gpg]
           format = ssh
   [user]
           signingkey = "<YOUR_PUBLIC_KEY>"
           name = <USER_NAME>
           email = <USER_EMAIL>
   [commit]
           gpgsign = true
   

SSH gebruiken om te authenticeren met Git kan veiligheid en gebruiksgemak aan je werkproces toevoegen. Op dezelfde manier kunnen SSH sleutels opgeslagen in Bitwarden gebruikt worden om Git commits te ondertekenen en verifiëren met het SSH protocol. In dit voorbeeld zal de Bitwarden SSH Agent gebruikt worden om Git commits naar GitHub te ondertekenen.

1. Op je GitHub account, stel een SSH ondertekeningssleutel in door te navigeren naar Instellingen, SSH en GPG sleutels, en kies dan Nieuwe SSH Sleutel.

2. Op het scherm Nieuwe SSH-sleutel toevoegen, voeg een Naam toe en selecteer een Sleuteltype, Kies Ondertekeningssleutel. Kopieer en plak de publieke sleutel van je Bitwarden kluis in het sleutelveld op GitHub.

3. Configureer git om het allowedSignersFile te gebruiken met het volgende commando:
   

   Plain TextCopy
   git config --global gpg.ssh.allowedSignersFile "$HOME/.ssh/allowed_signers"

4. Voeg je publieke sleutel toe aan het allowedSignersFile:
   

   BashCopy
   # Create allowed_signers file
   touch ~/.ssh/allowed_signers
   
   # Edit the allowed_signers file and add a line for your public key pair you wish to trust, for example:
    User1@Bitwarden.com ssh-ed25519 <Your_Public_Key>

5. Gebruik de SSH sleutel om je repository te klonen met de SSH methode:
   

   

   Plain TextCopy
   git clone git@github.com:<USER>/<repository>.git

6. Maak de Git commit met terminal of je favoriete tekstverwerker:
   

   Plain TextCopy
   git commit -m "This commit is signed using SSH"

7. Bitwarden zal je vragen om het sleutelgebruik te autoriseren:
   

   

   
   

8. Eenmaal geautoriseerd, zal de SSH sleutel geïnitieerd worden om de commit goed te keuren. Je kunt nu de commit pushen:
   

   Plain TextCopy
   git push

9. Je kunt je vastlegging op Github verifiëren door naar GitHub commits te gaan:

   

SSH agent doorsturen staat een externe server waar je toegang tot hebt toe om je te authenticeren op andere servers met behulp van jouw sleutels, zonder je privésleutels bloot te stellen buiten je kluis. De server waarop u bent ingelogd kan uw lokale Bitwarden-instantie verzoeken om zich te authenticeren op de externe server. In dit voorbeeld demonstreren we het uitwisselen van bestanden tussen servers:

1. Controleer om te beginnen of de SSH-agent is ingeschakeld op uw Bitwarden desktop-app door te navigeren naar Instellingen en SSH-agent inschakelen:
   

   

2. Maak een nieuwe SSH-sleutel aan of importeer een bestaande SSH-sleutel in uw Bitwarden-desktopapplicatie.
   

3. Activeer agent doorsturen door een verbinding te openen met de server waar u bestanden naartoe wilt sturen:
   

   Plain TextCopy
   ssh -A <HostnameA>

4. Stuur een bestand naar de server:
   

   Plain TextCopy
   rsync -avzP ./TEST.txt <USER>@<HostnameB>:/home/<USER>/test.txt

5. Bitwarden zal vragen om de toegang tot de SSH-sleutel goed te keuren. Dit laat zien dat de SSH-sleutel is aangevraagd en gebruikt om de bestandsoverdracht te voltooien.