Configura tu Nexus

Sigue estos pasos cuando desees conectarte al repositorio de artefactos de Agora de Deque desde tu instancia de repositorio Nexus. Configurar este repositorio remoto autenticado dentro de Nexus permite a tus usuarios acceder a los componentes de Axe DevTools a través de tu propia red de distribución de software.

Requisitos previos

Debe tener credenciales de inicio de sesión en Agora y credenciales de administrador para su instancia de Nexus para configurar esta conexión de repositorio. Deque recomienda usar una cuenta de servicio de Agora para esas credenciales en lugar de una cuenta personal.

Uso de una Cuenta de Servicio

Deque recomienda que autentiques esta conexión con una cuenta de servicio de Agora en lugar de con tu propio inicio de sesión de Agora. Una cuenta de servicio es una cuenta de Agora que pertenece a tu equipo en vez de una cuenta personal que pertenece a un solo miembro del equipo.

Tu gestor de repositorios, el servidor que aloja el repositorio remoto que estás configurando, almacena las credenciales de la cuenta de servicio y las utiliza cada vez que necesita conectarse a Agora. No descarga los paquetes por adelantado. La primera vez que uno de tus desarrolladores o canales de integración continua instala un paquete de Axe DevTools, el repositorio remoto obtiene ese paquete de Agora y conserva una copia; las instalaciones posteriores se sirven desde esa copia. Tus desarrolladores y sistemas automatizados solo solicitan paquetes a tu gestor de repositorios, por lo que nunca necesitan sus propias cuentas de Agora.

Una conexión basada en el inicio de sesión de una sola persona depende de que esa persona mantenga el acceso a Agora. Si deja tu organización, nadie puede iniciar sesión en su cuenta para recrear el Token de Identidad cuando caduca, y las instalaciones fallan para todos. Una cuenta de servicio no depende de una sola persona.

Cuidando la Cuenta de Servicio

Trata el Token de Identidad de la cuenta de servicio — la credencial similar a una contraseña que Agora emite para la cuenta — como una credencial de infraestructura compartida, y adminístralo siguiendo las políticas de seguridad y credenciales de tu organización. Almacénalo en un gestor de secretos o en el almacén de secretos de tu proveedor de CI y haz referencia a él desde la configuración de tu gestor de repositorios, en lugar de comprometerlo en el control de versiones. Pide a Deque que limite el alcance de la cuenta de servicio solo al acceso de lectura que necesita cuando la solicites, y pídenos que revoquemos y renovemos el token si puede haber sido expuesto o cuando cambie el propietario de la cuenta.

Asigna un propietario a la cuenta desde dentro de tu organización. Los Tokens de Identidad caducan (normalmente después de un año), por lo que el propietario de la cuenta debe recrear el token antes de que caduque. Quien lo recree también debe actualizar el token almacenado que tu gestor de repositorios usa para conectarse a Agora, porque tu gestor de repositorios no puede descargar paquetes nuevos y actualizados hasta que se actualice el token almacenado.

Creación de un Token de Identidad

Para comenzar, inicie sesión en Agora con la cuenta de servicio, de modo que el Token de Identidad pertenezca a la cuenta de servicio en lugar de a una cuenta personal. Si no está usando una cuenta de servicio, inicie sesión como usted mismo. Haga clic en el botón Bienvenido en la esquina superior derecha para abrir la página de perfil. Genere un Token de Identidad allí y cópielo.

Conectando a Agora

1. Inicia sesión en tu Nexus Repository Manager con tus credenciales de administrador.
2. Selecciona el ícono de engranaje en el encabezado del administrador del repositorio Nexus. La página de administración de repositorios debería mostrarse con la barra lateral izquierda actualizada para mostrar el menú Administración.
3. Selecciona Repositorios (Administración del repositorio) para mostrar la página de repositorios.
4. Selecciona Crear repositorio en la parte superior de la página de repositorios.
5. La página de repositorios debería mostrar una lista de recetas. Selecciona una versión proxy del lenguaje que deseas usar con Axe DevTools en la tabla Seleccionar Receta.
6. La página Crear Repositorio debería mostrar un formulario. Recomendamos utilizar los ajustes predeterminados excepto para lo siguiente:
   1. Ubicación de almacenamiento remoto para Axe DevTools:

      Receta	Utiliza esta URL de Artifactory (haz triple clic para seleccionar)
      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 selección del cuadro de autenticación y observa que el menú de tipo de autenticación muestra la opción de lista Nombre de usuario en la sección HTTP.
   3. Ingrese la dirección de correo electrónico de la cuenta de servicio como nombre de usuario y el Token de Identidad que copió como la contraseña. Si no está usando una cuenta de servicio, ingrese la dirección de correo electrónico de la cuenta de Agora con la que inició sesión.
7. Selecciona Crear repositorio en la esquina inferior izquierda de la página Crear Repositorio: <receta que seleccionaste>.
8. Si tiene éxito, se mostrará un mensaje indicando la creación del repositorio remoto.