Richten Sie Ihr Nexus ein

Folgen Sie diesen Schritten, wenn Sie sich von Ihrer Nexus-Repository-Instanz aus mit Deques Agora-Artefakt-Repository verbinden möchten. Das Einrichten dieses authentifizierten Remote-Repositorys innerhalb von Nexus ermöglicht es Ihren Benutzern, Axe DevTools-Komponenten über Ihr eigenes Softwareverteilungsnetzwerk zuzugreifen.

Voraussetzungen

Sie müssen über Agora-Login-Daten und Admin-Anmeldedaten für Ihre Nexus-Instanz verfügen, um diese Repository-Verbindung zu konfigurieren. Deque empfiehlt, für diese Anmeldedaten ein Agora-Dienstkonto anstelle eines persönlichen Kontos zu verwenden.

Verwendung eines Dienstkontos

Deque empfiehlt, diese Verbindung mit einem Agora-Dienstkonto zu authentifizieren, anstatt mit Ihrem eigenen Agora-Login. Ein Dienstkonto ist ein Agora-Konto, das zu Ihrem Team gehört, und nicht ein persönliches Konto, das nur einem Teammitglied gehört.

Ihr Repository-Manager — der Server, der das von Ihnen eingerichtete Remote-Repository hostet — speichert die Anmeldedaten des Dienstkontos und verwendet sie, wann immer er Zugriff auf Agora benötigt. Er lädt die Pakete nicht im Voraus herunter. Das erste Mal, wenn einer Ihrer Entwickler oder Build-Pipelines ein Axe DevTools-Paket installiert, ruft das Remote-Repository dieses Paket von Agora ab und behält eine Kopie, und spätere Installationen erfolgen von dieser Kopie. Ihre Entwickler und automatisierten Systeme fragen Pakete nur von Ihrem Repository-Manager an, sodass sie niemals eigene Agora-Konten benötigen.

Eine Verbindung, die auf dem Login einer einzelnen Person basiert, hängt davon ab, dass diese Person Zugang zu Agora behält. Wenn sie Ihre Organisation verlässt, kann sich niemand in ihr Konto einloggen, um das Identity Token bei Ablauf neu zu erstellen, und Installationen schlagen dann für alle fehl. Ein Dienstkonto hängt nicht von einer einzelnen Person ab.

Pflege des Dienstkontos

Behandeln Sie das Identity Token des Dienstkontos — die passwortähnliche Berechtigung, die Agora für das Konto ausstellt — als eine gemeinsam genutzte Infrastruktur-Berechtigung und verwalten Sie es gemäß den Sicherheits- und Berechtigungrichtlinien Ihrer Organisation. Speichern Sie es in einem Secrets-Manager oder im Secret-Store Ihres CI-Anbieters und referenzieren Sie es von der Konfiguration Ihres Repository-Managers, anstatt es in die Quellcode-Verwaltung einzufügen. Bitten Sie Deque, das Dienstkonto nur auf den Lesezugriff zu beschränken, den es benötigt, wenn Sie es anfordern, und bitten Sie uns, das Token zu widerrufen und neu auszustellen, wenn es möglicherweise offengelegt wurde oder wenn sich der Kontoinhaber ändert.

Weisen Sie dem Konto einen Inhaber innerhalb Ihrer Organisation zu. Identity Tokens laufen ab (normalerweise nach einem Jahr), daher muss der Kontoinhaber das Token vor Ablauf neu erstellen. Wer auch immer es neu erstellt, muss auch das gespeicherte Token aktualisieren, das Ihr Repository-Manager zur Verbindung mit Agora verwendet, da Ihr Repository-Manager keine neuen und aktualisierten Pakete herunterladen kann, bis das gespeicherte Token aktualisiert wird.

Erstellung eines Identity Tokens

Um zu beginnen, bei Agora anmelden als das Dienstkonto, sodass das Identitätstoken dem Dienstkonto und nicht einem persönlichen Konto gehört. Wenn Sie kein Dienstkonto verwenden, melden Sie sich als sich selbst an. Klicken Sie auf die Willkommen-Schaltfläche in der oberen rechten Ecke, um die Profilseite zu öffnen. Generieren Sie dort ein Identitätstoken und kopieren Sie es.

Verbindung mit Agora

1. Melden Sie sich mit Ihren Admin-Zugangsdaten bei Ihrem Nexus Repository Manager an.
2. Wählen Sie das Zahnrad-Symbol in der Kopfzeile des Nexus Repository Managers. Die Repository-Verwaltungsseite sollte mit der aktualisierten linken Seitenleiste angezeigt werden, um das Verwaltung-Menü darzustellen.
3. Wählen Sie Repositories (Repository-Verwaltung), um die Repository-Seite anzuzeigen.
4. Wählen Sie Repository erstellen oben auf der Repository-Seite.
5. Die Repository-Seite sollte eine Liste von Rezepten anzeigen. Wählen Sie eine Proxy-Version der Sprache, die Sie mit Axe DevTools verwenden möchten, in der Rezept auswählen-Tabelle aus.
6. Die Repository erstellen-Seite sollte ein Formular anzeigen. Wir empfehlen die Verwendung der Standardeinstellungen, mit Ausnahme der folgenden:
   1. Remote-Speicherort für Axe DevTools:

      Rezept	Verwenden Sie diese Artifactory-URL (dreifach klicken zum Auswählen)
      npm (Proxy)	https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
      maven2 (Proxy)	https://agora.dequecloud.com/artifactory/devtools-maven/
      nuget (Proxy)	https://agora.dequecloud.com/artifactory/api/nuget/devtools-nuget/
      rubygems (Proxy)	https://agora.dequecloud.com/artifactory/devtools-gems/
      pypi (Proxy)	https://agora.dequecloud.com/artifactory/api/pypi/devtools-python/simple/

   2. Verifizieren Sie die Auswahl des Authentifizierungsfeldes und beachten Sie, dass das Authentifizierungstyp-Menü die Benutzername Listenoption im HTTP-Bereich anzeigt.
   3. Geben Sie die E-Mail-Adresse des Dienstkontos als Benutzernamen und das von Ihnen kopierte Identitätstoken als Passwort ein. Wenn Sie kein Dienstkonto verwenden, geben Sie die E-Mail-Adresse des Agora-Kontos ein, mit dem Sie sich angemeldet haben.
7. Wählen Sie Repository erstellen in der unteren linken Ecke der Repository erstellen: <ausgewähltes Rezept>-Seite.
8. Wenn erfolgreich, wird eine Nachricht angezeigt, die die Erstellung des Remote-Repositorys anzeigt.