Skip to main content

Informationen zu SSH-Zertifizierungsstellen

Mit einer SSH-Zertifizierungsstelle kann Ihre Organisation oder Ihr Unternehmenskonto SSH-Zertifikate bereitstellen, die Mitglieder und externe Mitarbeiter für den Zugriff auf Ihre Ressourcen mit Git verwenden können.

Informationen zu SSH-Zertifizierungsstellen

Ein SSH-Zertifikat ist ein Mechanismus, mit dem ein SSH-Schlüssel einen anderen SSH-Schlüssel signieren kann. Wenn Sie eine SSH-Zertifizierungsstelle (CA) verwenden, um Ihren Organisationsmitgliedern und externen Mitarbeitern signierte SSH-Zertifikate bereitzustellen, können Sie die CA zu Ihrem Unternehmenskonto oder Ihrer Organisation hinzufügen, damit diese Organisationsmitarbeiter ihre Zertifikate für den Zugriff auf Organisationsressourcen verwenden können.

Wenn Sie eine SSH-Zertifizierungsstelle zu Ihrem Organisations- oder Enterprise-Konto hinzugefügt haben, können Sie die Zertifizierungsstelle verwenden, um Client-SSH-Zertifikate für Organisationsmitglieder und externe Mitarbeiter zu signieren. Diese Mitwirkenden der Organisation können die signierten Zertifikate verwenden, um auf die Repositories dieser Organisation zuzugreifen.

Zertifikate, die Ihrem Unternehmen hinzugefügt wurden, gewähren Zugriff auf alle Organisationen, die ihrem Enterprise-Konto gehören. Weitere Informationen findest du unter Erzwingen von Richtlinien für Sicherheitseinstellungen in deinem Unternehmen.

Du kannst festlegen, dass Mitglieder für den Zugriff auf Organisationsressourcen SSH-Zertifikate verwenden müssen, sofern SSH nicht in deinem Repository deaktiviert ist.

Optional können Sie festlegen, dass Mitglieder und externe Mitarbeiter SSH-Zertifikate für den Zugriff auf Organisationsressourcen verwenden. Weitere Informationen finden Sie unter SSH-Zertifizierungsstellen Deiner Organisation verwalten und unter Erzwingen von Richtlinien für Sicherheitseinstellungen in deinem Unternehmen.

Du kannst beispielsweise ein internes System einrichten, das jeden Morgen ein neues Zertifikat für deine Entwickler herausgibt. Die Entwickler*innen können mit ihrem aktuellen Zertifikat in den Repositorys deiner Organisation auf GitHub Enterprise Server arbeiten. Am Ende des Tages läuft das Zertifikat automatisch ab. So werden deine Repositorys geschützt, falls das Zertifikat zu einem späteren Zeitpunkt kompromittiert wird.

Mitglieder können das Zertifikat nicht für den Zugriff auf Forks der Repositorys der Organisation verwenden, es sei denn, das Unternehmen hat SSH-CAs für den Zugriff auf Repositorys im Besitz von Benutzern zugelassen. Weitere Informationen findest du unter Informationen zu SSH-Zertifizierungsstellen.

Informationen zu SSH-URLs mit SSH-Zertifikaten

Falls Ihre Organisation SSH-Zertifikate verlangt, sollten Organisationsmitglieder und externe Mitarbeiter eine spezielle URL mit der Organisations-ID verwenden, wenn sie Git-Vorgänge über SSH ausführen. So können Authentifizierungsfehler vermieden werden. Mit dieser speziellen URL können der Client und der Server einfacher aushandeln, welche Schlüssel auf dem Computer des Mitglieds für die Authentifizierung verwendet werden sollen. Wenn ein Mitglied die normale URL verwendet, die mit git@github.com anfängt, bietet der SSH-Client möglicherweise den falschen Schlüssel an, wodurch der Vorgang fehlschlägt.

Jeder mit Lesezugriff auf das Repository kann diese URL finden, indem er das Dropdownmenü Code auf der Hauptseite des Repositorys auswählt und dann auf SSH verwenden klickt.

Wenn Ihre Organisation keine SSH-Zertifikate verlangt, können Mitwirkende weiterhin eigene SSH-Schlüssel oder andere Authentifizierungsmethoden verwenden. In diesem Fall funktioniert entweder die spezielle URL oder die normale URL, die mit git@github.com beginnt.

Ausgabe von Zertifikaten

Beim Herausgeben der einzelnen Zertifikate musst du eine Erweiterung hinzufügen, die festlegt, für welchen GitHub Enterprise Server-Benutzer das Zertifikat gedacht ist. Auf Benutzer*innen können Sie über den Anmeldehandle verweisen. Sie können z. B. den OpenSSH-Befehl ssh-keygen verwenden und dabei KEY-IDENTITY durch die eigene Schlüsselidentität und USERNAME durch einen GitHub Enterprise Server-Benutzernamen ersetzen. Das von dir generierte Zertifikat ist berechtigt, im Auftrag dieses Benutzers bzw. dieser Benutzerin für alle Ressourcen deiner Organisation zu handeln. Stelle sicher, dass du die Identität des Benutzers überprüfst, bevor du das Zertifikat ausstellst.

Note

Du musst ein Update auf OpenSSH 7.6 oder höher durchführen, um diese Befehle verwenden zu können.

Zur Identifizierung des Benutzers mit login verwenden Sie extension:login:

ssh-keygen -s ./ca-key -V '+1d' -I KEY-IDENTITY -O extension:login@HOSTNAME=USERNAME ./user-key.pub

Warning

Nachdem ein Zertifikat signiert und ausgestellt wurde, kann es nicht mehr widerrufen werden.

Für Zertifizierungsstellen, die zur GitHub Enterprise Server-Version 3.13 oder höher hochgeladen wurden, müssen Sie das Flag -V nutzen, um für das Zertifikat eine Lebensdauer von weniger als 366 Tage zu konfigurieren. Für Zertifizierungsstellen, die vor Version 3.13 hochgeladen wurden, ist das Flag -V optional. Sie können dann Zertifikate erstellen, die unwiderruflich und unbegrenzt gültig sind.

Um ein Zertifikat für eine Person auszustellen, die SSH verwendet, um auf mehrere GitHub-Produkte zuzugreifen, kannst du zwei Anmeldeerweiterungen einschließen, um den Benutzernamen für jedes Produkt anzugeben. Zum Beispiel würde der folgende Befehl ein Zertifikat für USERNAME-1 für das Benutzerkonto für GitHub Enterprise Cloud und USERNAME-2 für das Benutzerkonto auf GitHub Enterprise Server auf HOSTNAME ausstellen.

ssh-keygen -s ./ca-key -V '+1d' -I KEY-IDENTITY -O extension:login@github.com=USERNAME-1 extension:login@HOSTNAME=USERNAME-2 ./user-key.pub

Mit der Erweiterung source-address schränkst du die IP-Adressen ein, von denen aus ein Organisationsmitglied auf die Ressourcen deiner Organisation zugreifen kann. Als Erweiterung ist eine bestimmte IP-Adresse oder ein IP-Adressbereich mit CIDR-Notation zulässig. Sollen mehrere Adressen oder Bereiche angegeben werden, trenne sie durch Komma voneinander ab. Weitere Informationen findest du unter Klassenloses Routing zwischen Domänen auf Wikipedia.

ssh-keygen -s ./ca-key -V '+1d' -I KEY-IDENTITY -O extension:login@HOSTNAME=USERNAME -O source-address=COMMA-SEPARATED-LIST-OF-IP-ADDRESSES-OR-RANGES ./user-key.pub