Richten Sie Ihr Artifactory ein

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Konfiguration Ihrer Artifactory-Instanz zur Verbindung mit Deques Agora-Artefakt-Repository

Not for use with personal data

Konfiguration Ihres Artifactory-Repositories zur Verbindung mit Deques Agora-Artefakt-Repository

Folgen Sie diesen Schritten, um sich von Ihrer Artifactory-Instanz mit Deques Agora-Artefakt-Repository zu verbinden. Das Einrichten dieses authentifizierten Remote-Repositorys in Artifactory ermöglicht es Ihren Benutzern, auf Axe DevTools-Komponenten über Ihr eigenes Softwareverteilungsnetzwerk zuzugreifen.

Voraussetzungen

Sie müssen über Agora-Anmeldedaten und Administratoranmeldedaten für Ihre Artifactory-Instanz verfügen, um diese Repository-Verbindung zu konfigurieren. Deque empfiehlt, ein Agora-Dienstkonto für diese Anmeldedaten zu verwenden, anstatt ein persönliches Konto.

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.

note

Um ein Dienstkonto anzufordern, kontaktieren Sie Ihren Deque-Vertreter direkt, fragen Sie uns über unseren Supportdesk, oder senden Sie uns eine E-Mail. Wir helfen Ihnen gerne bei der Einrichtung.

Erstellen eines Agora-Identitätstokens

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

important

Denken Sie daran, den Wert Ihres Identity Tokens beim Erstellen zu kopieren, da dies Ihre einzige Chance sein wird. Andernfalls müssen Sie ein neues Token erstellen.

Identity Tokens laufen ab (in der Regel nach einem Jahr), daher müssen Sie Ihr Token regelmäßig neu erstellen.

Verbindung zu Agora

Melden Sie sich mit Ihren Admin-Zugangsdaten bei Ihrem Artifactory Repository Manager an.
Wählen Sie Admin im linken Navigationsmenü aus.
Wählen Sie „Remote“ unter „Repositories“, um die Seite der Remote-Repositories anzuzeigen.
Wählen Sie „Neu erstellen“ oben rechts auf der Seite der Remote-Repositories.
Die Seite sollte eine Liste der Pakettypen anzeigen
Wählen Sie Ihren Pakettyp (z. B. npm)
Die Seite „Repository erstellen“ sollte ein Formular anzeigen (siehe oben Beispiel für ein npm-Repository).
1. Geben Sie im Feld Repository-Schlüssel den Namen ein, den Sie für das Repository verwenden möchten. Der Repository-Schlüssel darf keine Leerzeichen oder Sonderzeichen enthalten, muss eindeutig sein, darf nicht mit einer Zahl beginnen und ist auf 58 Zeichen begrenzt.
2. Geben Sie die URL zum Agora-Register ein (siehe Agora-Registry-URLs unten).
3. Wählen Sie die geeigneten Layouts (Standardeinstellungen sollten für jeden Repository-Typ funktionieren)
Klicken Sie auf die Schaltfläche „Test“, um die Verbindung zu testen
Klicken Sie auf „Speichern und beenden“
Wenn Benutzer dieses Repository standardmäßig verwenden sollen, müssen Sie es in eines Ihrer virtuellen Registries aufnehmen

Agora-Registry-URLs

important

Diese Links sind nicht zum Besuch gedacht. Stattdessen klicken Sie mit der rechten Maustaste auf den gewünschten Link, wählen Sie Link kopieren aus und fügen Sie die URL auf der Agora-Einrichtungsseite für die URL des Agora-Registers ein.