Configurer votre Artifactory

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

Configurer votre instance Artifactory pour se connecter au dépôt d'artefacts Agora de Deque

Not for use with personal data

Configurer votre dépôt Artifactory pour se connecter au dépôt d'artefacts Agora de Deque

Suivez ces étapes lorsque vous souhaitez vous connecter au dépôt d'artefacts Agora de Deque depuis votre instance Artifactory. Configurer ce dépôt distant authentifié dans Artifactory permet à vos utilisateurs d'accéder aux composants d'Axe DevTools via votre propre réseau de distribution de logiciels.

Prérequis

Vous devez avoir des identifiants de connexion Agora et des identifiants administratifs pour votre instance Artifactory afin de configurer cette connexion de dépôt. Deque recommande d'utiliser un compte de service Agora pour ces identifiants plutôt qu'un compte personnel.

Utilisation d'un compte de service

Deque recommande d'authentifier cette connexion avec un compte de service Agora plutôt qu'avec votre propre connexion Agora. Un compte de service est un compte Agora qui appartient à votre équipe plutôt qu'à un compte personnel qui appartient à un seul membre de l'équipe.

Votre gestionnaire de dépôt — le serveur qui héberge le dépôt distant que vous configurez — stocke les informations d'identification du compte de service et les utilise chaque fois qu'il doit accéder à Agora. Il ne télécharge pas les paquets à l'avance. La première fois qu'un de vos développeurs ou pipelines de construction installe un paquet Axe DevTools, le dépôt distant récupère ce paquet depuis Agora et en conserve une copie, et les installations ultérieures sont servies à partir de la copie. Vos développeurs et systèmes automatisés ne demandent des paquets qu'à votre gestionnaire de dépôt, ils n'ont donc jamais besoin de leurs propres comptes Agora.

Une connexion basée sur la connexion d'une seule personne dépend de cette personne pour conserver l'accès à Agora. Si elle quitte votre organisation, personne ne peut se connecter à son compte pour recréer le Jeton d'Identité lorsqu'il expire, et les installations échouent alors pour tout le monde. Un compte de service ne dépend pas d'une seule personne.

Prendre soin du compte de service

Traitez le Jeton d'Identité du compte de service — la référence semblable à un mot de passe qu'Agora émet pour le compte — comme une référence d'infrastructure partagée, et gérez-le conformément aux politiques de sécurité et de référence de votre organisation. Stockez-le dans un gestionnaire de secrets ou le magasin de secrets de votre fournisseur CI et référencez-le à partir de la configuration de votre gestionnaire de dépôt, plutôt que de le valider dans le contrôle de version. Demandez à Deque de limiter le compte de service uniquement à l'accès en lecture dont il a besoin lorsque vous le demandez, et demandez-nous de révoquer et de réémettre le jeton s'il a pu être exposé ou lorsque le propriétaire du compte change.

Assignez un propriétaire au compte au sein de votre organisation. Les Jetons d'Identité expirent (généralement après un an), donc le propriétaire du compte doit recréer le jeton avant qu'il n'expire. Celui qui le recrée doit également mettre à jour le jeton stocké que votre gestionnaire de dépôt utilise pour se connecter à Agora, car votre gestionnaire de dépôt ne peut pas télécharger de nouveaux paquets et mises à jour tant que le jeton stocké n'est pas mis à jour.

note

Pour demander un compte de service, contactez directement votre représentant Deque, demandez-nous via notre bureau d'assistance, ou envoyez-nous un email. Nous serons ravis de vous aider à en configurer un.

Créer un jeton d'identité Agora

Pour commencer, connectez-vous à Agora en tant que compte de service, afin que le jeton d'identité appartienne au compte de service et non à un compte personnel. Si vous n'utilisez pas de compte de service, connectez-vous en votre nom. Cliquez sur le bouton Bienvenue dans le coin supérieur droit pour ouvrir la page de profil. Générer un jeton d'identité là-bas et copiez-le.

important

N'oubliez pas de copier la valeur de votre jeton d'identité lors de sa création, car ce sera votre seule occasion. Sinon, vous devrez créer un nouveau jeton.

Les jetons d'identité expirent (généralement après un an), vous devrez donc recréer votre jeton périodiquement.

Connexion à Agora

Connectez-vous à votre gestionnaire de dépôt Artifactory avec vos identifiants administrateurs.
Sélectionnez Admin dans le menu de navigation à gauche.
Sélectionnez « Remote » sous « Repositories » pour afficher la page des dépôts distants.
Sélectionnez « Create New » en haut à droite de la page des dépôts distants.
La page doit afficher une liste de types de paquets
Sélectionnez votre type de paquet (par exemple, npm)
La page de création de dépôt doit afficher un formulaire (voir un exemple ci-dessus d'un dépôt npm).
1. Dans le champ Repository Key, saisissez le nom que vous souhaitez utiliser pour faire référence au dépôt. La clé du dépôt ne doit pas contenir d'espaces ou de caractères spéciaux, doit être unique, ne doit pas commencer par un chiffre, et est limitée à 58 caractères.
2. Entrez l'URL vers le registre Agora (voir URL du registre Agora ci-dessous).
3. Sélectionnez les mises en page appropriées (les valeurs par défaut devraient convenir à chaque type de dépôt)
Cliquez sur le bouton « Test » pour tester la connexion
Cliquez sur « Save and Finish »
Si vous souhaitez que les utilisateurs utilisent ce dépôt par défaut, vous devrez l'inclure dans l'un de vos registres virtuels.

URL du registre Agora

important

Ces liens ne sont pas destinés à être visités. Au lieu de cela, faites un clic droit sur le lien souhaité, choisissez Copier le lien, puis collez l'URL dans la page de configuration d'Agora pour l'URL du registre Agora.