Registrieren eines Agents mithilfe eines persönlichen Zugriffstokens (PAT)

  • Artikel

Geben Sie bei der Konfiguration des Agents PAT als Authentifizierungstyp an, um ein persönliches Zugriffstoken (PAT) für die Authentifizierung während der Registrierung des Agents zu verwenden. Geben Sie dann ein persönliches Zugriffstoken mit dem Bereich Agentpools (Lesen, Verwalten) (oder dem Bereich Bereitstellungsgruppe (Lesen, Verwalten) für einen Bereitstellungsgruppen-Agent) an, das für die Registrierung des Agents verwendet werden kann.

Ein einzelnes PAT kann für die Registrierung mehrerer Agents verwendet werden. Das PAT wird nur bei der Registrierung des Agents verwendet, nicht für die nachfolgende Kommunikation.

Um ein PAT mit Azure DevOps Server zu verwenden, muss Ihr Server mit HTTPS konfiguriert werden. Weitere Informationen finden Sie unter Websiteeinstellungen und Sicherheit.

Erstellen eines persönlichen Zugriffstokens für die Registrierung des Agents

  1. Melden Sie sich mit dem Benutzerkonto an, das Sie in Ihrem Azure DevOps Server-Webportal (https://{your-server}/DefaultCollection/) verwenden möchten.
  1. Melden Sie sich mit dem Benutzerkonto an, das Sie in Ihrer Azure DevOps-Organisation (https://dev.azure.com/{your_organization}) verwenden möchten.

  1. Öffnen Sie auf der Startseite Ihr Profil. Navigieren zu Ihren Sicherheitsdetails.

    Screenshot der Sicherheitsdetails in Azure DevOps Server.

  2. Erstellen Sie ein persönliches Zugriffstoken.

    Screenshot des Erstellens eines persönlichen Zugriffstokens in Azure DevOps Server.

    Hinweis

    Wenn Sie einen Bereitstellungsgruppen-Agent konfigurieren oder beim Registrieren einer VM-Umgebungsressource ein Fehler angezeigt wird, müssen Sie den PAT-Bereich auf Alle zugänglichen Organisationen festlegen. Screenshot: Festlegen des PAT-Bereichs auf „Alle zugänglichen Organisationen“.

  1. Öffnen Sie über die Startseite Ihre Benutzereinstellungen, und wählen Sie dann Persönliche Zugriffstoken aus.

    Screenshot der Sicherheitsdetails.

  2. Erstellen Sie ein persönliches Zugriffstoken.

    Screenshot des Erstellens eines persönlichen Zugriffstokens.

  1. Wählen Sie für den Bereich Agent-Pools (Lesen, Verwalten) aus, und stellen Sie sicher, dass alle anderen Kontrollkästchen deaktiviert sind. Wenn es sich um einen Bereitstellungsgruppen-Agent handelt, wählen Sie für den Bereich Bereitstellungsgruppe (lesen, verwalten) aus, und stellen Sie sicher, dass alle anderen Kontrollkästchen deaktiviert sind.

    Wählen Sie am unteren Rand des Fensters Neues persönliches Zugriffstoken erstellen die Option Alle Bereiche anzeigen aus, um die vollständige Liste der Bereiche anzuzeigen.

  2. Kopiere das Token. Sie benötigen dieses Token, wenn Sie den Agent konfigurieren.

Hinweis

Bei Verwendung von PAT als Authentifizierungsmethode wird das PAT-Token nur für die Erstkonfiguration des Agents verwendet. Weitere Informationen finden Sie unter Kommunikation mit Azure Pipelines oder TFS.

Nächste Schritte