Configurer votre Nexus

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

Prérequis

Vous devez disposer des identifiants de connexion Agora et des identifiants administrateur pour votre instance Nexus 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.

Créer un jeton d'identité

Pour commencer, connectez-vous à Agora en tant que compte de service, afin que le jeton d'identité appartienne au compte de service plutôt qu'à un compte personnel. Si vous n'utilisez pas de compte de service, connectez-vous en tant que vous-même. Cliquez sur le bouton Bienvenue dans le coin supérieur droit pour ouvrir la page de profil. Générez un jeton d'identité à cet endroit et copiez-le.

Connexion à Agora

1. Connectez-vous à votre Nexus Repository Manager avec vos identifiants administrateur.
2. Sélectionnez l'icône d'engrenage dans l'en-tête du gestionnaire de dépôt Nexus. La page d'administration du dépôt devrait s'afficher avec la barre latérale gauche actualisée pour afficher le menu Administration.
3. Sélectionnez Dépôts (Administration du dépôt) pour afficher la page des dépôts.
4. Sélectionnez Créer un dépôt en haut de la page des dépôts.
5. La page des dépôts devrait afficher une liste de recettes. Sélectionnez une version proxy de la langue que vous souhaitez utiliser avec Axe DevTools dans la table Sélectionner la recette.
6. La page Créer le dépôt devrait afficher un formulaire. Nous recommandons d'utiliser les paramètres par défaut, sauf pour les exceptions suivantes :
   1. Emplacement de stockage distant pour Axe DevTools :

      Recette	Utilisez cette URL Artifactory (triple clic pour sélectionner)
      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. Vérifiez la sélection de la case d'authentification et notez que le menu du type d'authentification affiche l'option de liste Nom d'utilisateur dans la section HTTP.
   3. Entrez l'adresse e-mail du compte de service comme nom d'utilisateur et le jeton d'identité que vous avez copié comme mot de passe. Si vous n'utilisez pas de compte de service, entrez l'adresse e-mail du compte Agora avec lequel vous vous êtes connecté.
7. Sélectionnez Créer un dépôt dans le coin inférieur gauche de la page Créer un dépôt : <recette que vous avez sélectionnée>.
8. Si c'est réussi, un message s'affichera indiquant la création réussie du dépôt distant.