Configura il tuo Nexus

Segui questi passaggi per connetterti al repository di artefatti Agora di Deque dalla tua istanza di repository Nexus. Configurare questo repository remoto autenticato all'interno di Nexus consente ai tuoi utenti di accedere ai componenti Axe DevTools attraverso la tua rete di distribuzione software.

Prerequisiti

Devi avere le credenziali di accesso per Agora e le credenziali di admin per la tua istanza di Nexus per configurare questa connessione al repository. Deque consiglia di utilizzare un account di servizio Agora per queste credenziali anziché un account personale.

Utilizzare un Account di Servizio

Deque raccomanda di autenticare questa connessione con un account di servizio di Agora piuttosto che con il tuo account personale di Agora. Un account di servizio è un account di Agora che appartiene al tuo team piuttosto che a un singolo membro del team.

Il tuo gestore del repository — il server che ospita il repository remoto che stai configurando — memorizza le credenziali dell'account di servizio e le utilizza quando necessario per raggiungere Agora. Non scarica i pacchetti in anticipo. La prima volta che uno dei tuoi sviluppatori o pipeline di build installa un pacchetto Axe DevTools, il repository remoto recupera quel pacchetto da Agora e ne conserva una copia, e le installazioni successive vengono servite dalla copia. I tuoi sviluppatori e i sistemi automatizzati richiedono pacchetti solo al gestore del tuo repository, quindi non hanno mai bisogno dei propri account di Agora.

Una connessione basata sull'accesso di una singola persona dipende dal mantenimento dell'accesso ad Agora da parte di quella persona. Se lasciano la tua organizzazione, nessuno può accedere al loro account per ricreare il Token di Identità quando scade, e le installazioni falliscono per tutti. Un account di servizio non dipende da una sola persona.

Gestire l'Account di Servizio

Tratta il Token di Identità dell'account di servizio — la credenziale simile a una password emessa da Agora per l'account — come una credenziale di infrastruttura condivisa e gestiscila seguendo le politiche di sicurezza e di gestione delle credenziali della tua organizzazione. Archiviala in un gestore di segreti o nell'archiviazione dei segreti del tuo provider CI e fanne riferimento dalla configurazione del tuo gestore del repository, piuttosto che impegnarla nel controllo del codice sorgente. Chiedi a Deque di limitare l'account di servizio solo all'accesso in lettura necessario quando lo richiedi, e chiedici di revocare e riemettere il token se potrebbe essere stato esposto o quando cambia il proprietario dell'account.

Assegna un proprietario all'account all'interno della tua organizzazione. I Token di Identità scadono (di solito dopo un anno), quindi il proprietario dell'account deve ricreare il token prima che scada. Chiunque lo ricrei deve anche aggiornare il token memorizzato che il tuo gestore del repository utilizza per connettersi ad Agora, perché il gestore del tuo repository non può scaricare nuovi pacchetti e aggiornamenti fino a quando il token memorizzato non viene aggiornato.

Creazione di un Token d'Identità

Per iniziare, accedi ad Agora come account di servizio, in modo che il Token Identità appartenga all'account di servizio anziché a un account personale. Se non stai utilizzando un account di servizio, accedi come te stesso. Fai clic sul pulsante Benvenuto nell'angolo in alto a destra per aprire la pagina del profilo. Genera un Token Identità lì e copialo.

Connessione ad Agora

1. Accedi al tuo Nexus Repository Manager con le tue credenziali amministrative.
2. Seleziona l'icona a forma di ingranaggio nell'intestazione del gestore del repository Nexus. La pagina di amministrazione del repository dovrebbe essere visualizzata con la barra laterale sinistra aggiornata per mostrare il menu Amministrazione.
3. Seleziona Repository (Amministrazione repository) per visualizzare la pagina dei repository.
4. Seleziona Crea repository nella parte superiore della pagina dei repository.
5. La pagina dei repository dovrebbe visualizzare un elenco di ricette. Seleziona una versione proxy del linguaggio che desideri utilizzare con Axe DevTools nella tabella Seleziona Ricetta.
6. La pagina Crea Repository dovrebbe visualizzare un modulo. Consigliamo di utilizzare le impostazioni predefinite, tranne per quanto segue:
   1. Posizione di archiviazione remota per Axe DevTools:

      Ricetta	Usa questo URL di Artifactory (seleziona con triplo clic)
      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. Verifica la selezione del riquadro di autenticazione e nota che il menu tipo di autenticazione visualizza l'opzione elenco Nome utente nella sezione HTTP.
   3. Inserisci l'indirizzo email dell'account di servizio come nome utente e il Token Identità che hai copiato come password. Se non stai utilizzando un account di servizio, inserisci l'indirizzo email dell'account Agora con cui hai effettuato l'accesso.
7. Seleziona Crea repository nell'angolo in basso a sinistra della pagina Crea Repository: <ricetta che hai selezionato>.
8. Se l'operazione ha successo, verrà visualizzato un messaggio che indica la creazione del repository remoto.