Configurar su Artifactory

Configurar su repositorio de Artifactory para conectarse al repositorio de artefactos Agora de Deque

Siga estos pasos cuando desee conectarse al repositorio de artefactos Agora de Deque desde su instancia de Artifactory. Configurar este repositorio remoto autenticado dentro de Artifactory permite que sus usuarios accedan a los componentes de Axe DevTools a través de su propia red de distribución de software.

Requisitos previos

Debe tener credenciales de inicio de sesión de Agora y credenciales de administrador para su instancia de Artifactory 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.

Crear un Token de Identidad de Agora

Para comenzar, inicie sesión en Agora como la cuenta de servicio, para que el Token de Identidad pertenezca a la cuenta de servicio en lugar de a una cuenta personal. Si no está utilizando 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 allí un Token de Identidad y cópielo.

Conectarse a Agora

1. Inicie sesión en su Administrador de Repositorio de Artifactory con sus credenciales de administrador.
2. Seleccione Admin en el menú de navegación a la izquierda.
3. Seleccione “Remoto” bajo “Repositorios” para mostrar la página de repositorios remotos.
4. Seleccione “Crear Nuevo” en la parte superior derecha de la página de Repositorios Remotos.
5. La página debería mostrar una lista de tipos de paquetes
6. Seleccione su tipo de paquete (por ejemplo, npm)
7. La página de crear repositorio debería mostrar un formulario (vea el ejemplo anterior de un repositorio npm).
   1. En el campo Clave de Repositorio, escriba el nombre que le gustaría usar para referirse al repositorio. La clave del repositorio no debe contener espacios ni caracteres especiales, debe ser única, no debe comenzar con un número y está limitada a 58 caracteres.
   2. Ingrese la URL al registro de Agora (vea URLs del Registro de Agora a continuación).
   3. Seleccione los esquemas apropiados (los valores predeterminados deberían funcionar para cada tipo de repositorio)
8. Haga clic en el botón “Probar” para probar la conexión
9. Haga clic en “Guardar y Finalizar”
10. Si desea que los usuarios usen este repositorio por defecto, tendrá que incluirlo en cualquiera de sus registros virtuales

URLs del Registro de Agora

• npm: https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
• Maven: https://agora.dequecloud.com/artifactory/devtools-maven/
• NuGet: https://agora.dequecloud.com/artifactory/api/nuget/devtools-nuget/
• Gems: https://agora.dequecloud.com/artifactory/devtools-gems/
• Pip: https://agora.dequecloud.com/artifactory/api/pypi/devtools-python/simple/