Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Configura la autenticación en Artifact Registry para npm

Debes autenticarte en Artifact Registry cuando uses una aplicación de terceros para conectarte a un repositorio.

No es necesario que configures la autenticación para Cloud Build ni los entornos de ejecución de Google Cloud, como Google Kubernetes Engine y Cloud Run, pero debes verificar que estén configurados los permisos necesarios.

Node.js admite dos métodos para autenticar solicitudes en tu repositorio de Artifact Registry:

Tokens de acceso: Usa tokens de acceso cuando un usuario humano administre la autenticación en tu aplicación.
Autenticación con contraseña: Usa esta opción cuando una aplicación no admita credenciales predeterminadas de la aplicación, pero sí admita la autenticación con un nombre de usuario y una contraseña.

Antes de comenzar

Instala Google Cloud CLI. Después de instalarla, inicializa Google Cloud CLI ejecutando el siguiente comando:
```
gcloud init
```
Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Nota: Si ya instalaste gcloud CLI antes, asegúrate de tener la versión más reciente ejecutando gcloud components update.
Configura los valores predeterminados para los comandos de la gcloud CLI (opcional).
Si te conectas a repositorios desde Windows, instala PowerShell.
Crea una cuenta de servicio que actúe en nombre de tu aplicación.
Si eres nuevo en la Administración de socios de red, lee la descripción general con el fin de obtener información sobre los paquetes con alcance y el archivo de configuración para configuración de la autenticación.

Genera tokens para la autenticación

Para autenticar tu paquete en Artifact Registry, primero debes generar un token de autenticación. Luego, puedes usar este token cuando realices solicitudes desde tu paquete a Artifact Registry.

Puedes generar un token de acceso de oauth2 con Google Cloud o un token de oauth2l fuera de Google Cloud.

Los tokens de acceso son válidos durante 60 minutos. Genera un token de acceso poco antes de ejecutar comandos que interactúen con los repositorios. Si tu token de acceso venció, debes generar uno nuevo.

Genera un token con gcloud

Para generar un token de acceso de oauth2 con Google Cloud, ejecuta el siguiente comando:

export ACCESS_TOKEN="oauth2accesstoken:$(gcloud auth print-access-token)"

Ahora puedes hacer referencia a ACCESS_TOKEN cuando realices solicitudes desde tu paquete de Node.js a Artifact Registry.

Genera un token sin usar gcloud

Para generar un token de acceso solo con la CLI de oauth2l, haz lo siguiente:

Instala la versión más reciente de oauth2l ejecutando el siguiente comando:
```
go install github.com/google/oauth2l@latest
```
Ejecuta el comando siguiente:
```
export ACCESS_TOKEN="oauth2l fetch --scope cloud-platform"
```
Google Cloud genera un token de hash SHA256 y lo almacena en la variable ACCESS_TOKEN. Ahora puedes hacer referencia a ACCESS_TOKEN cuando realices solicitudes desde tu paquete de Node.js a Artifact Registry.

Configura la autenticación con contraseña con claves de cuenta de servicio

Usa este enfoque cuando la aplicación de Node.js requiera la autenticación con un nombre de usuario y una contraseña especificados.

Las claves de la cuenta de servicio son credenciales de larga duración. Usa los siguientes lineamientos para limitar el acceso a tus repositorios:

Considera usar una cuenta de servicio dedicada para interactuar con los repositorios.
Otorga la función mínima de Artifact Registry que requiera la cuenta de servicio. Por ejemplo, asigna la función de lector de Artifact Registry a una cuenta de servicio que solo descargue artefactos.
Si los grupos de tu organización requieren diferentes niveles de acceso a repositorios específicos, otorga acceso a nivel de repositorio en lugar de a nivel de proyecto.
Sigue las prácticas recomendadas para administrar credenciales.

Para crear una cuenta de servicio y configurar la autenticación, haz lo siguiente:

Crea una cuenta de servicio que actúe en nombre de tu aplicación o elige una cuenta de servicio existente que uses para la automatización.

Necesitarás la ubicación del archivo de claves de la cuenta de servicio para configurar la autenticación con Artifact Registry. En las cuentas existentes, puedes ver claves y crear claves nuevas en la página Cuentas de servicio.

Ir a la página Cuentas de servicio

Nota: Las claves de cuenta de servicio son un riesgo de seguridad si no se administran de forma adecuada. Debes elegir una alternativa más segura a las claves de la cuenta de servicio siempre que sea posible. Si te debes autenticar con una clave de cuenta de servicio, eres responsable de la seguridad de la clave privada y de otras operaciones que se describen en Prácticas recomendadas para administrar claves de cuentas de servicio. Si no se te permite crear una clave de cuenta de servicio, es posible que la creación de claves de cuentas de servicio esté inhabilitada para tu organización. Para obtener más información, consulta Administra los recursos de la organización con seguridad de forma predeterminada.
Si adquiriste la clave de cuenta de servicio de una fuente externa, debes validarla antes de usarla. Para obtener más información, consulta Requisitos de seguridad para las credenciales de origen externo.
Otorga el rol de Artifact Registry específico a la cuenta de servicio para proporcionar acceso al repositorio.
Si deseas activar la cuenta de servicio en la sesión actual de gcloud CLI, ejecuta el siguiente comando:
```
gcloud auth activate-service-account ACCOUNT --key-file=KEY-FILE
```
Dónde
- ACCOUNT es la cuenta de usuario o servicio.
- KEY-FILE es la ruta al archivo de claves JSON de la cuenta de servicio.
Ejecuta el siguiente comando para imprimir la configuración del repositorio:
```
gcloud artifacts print-settings npm [--project=PROJECT] \
[--repository=REPOSITORY] [--location=LOCATION] --scope=@SCOPE-NAME --json-key=KEY-FILE
```
Dónde
- PROJECT es el ID del proyecto. Si se omite esta marca, se usa el proyecto actual o predeterminado.
- REPOSITORY es el ID del repositorio. Si configuraste un repositorio predeterminado de Artifact Registry, se usa cuando se omite esta marca del comando.
- LOCATION es la ubicación regional o multirregional del repositorio.
- SCOPE-NAME es el nombre del permiso de la Administración de socios de red que se debe asociar con el repositorio.
  
  El uso de ámbitos garantiza que siempre publiques e instales paquetes desde el repositorio correcto.
  
  Los paquetes sin alcance se asocian con tu registro de npm predeterminado, que suele ser el registro público de npm. Si no especificas un permiso, la configuración que se muestra establece tu repositorio de Artifact Registry como el registro predeterminado. Esto puede causar problemas si tus proyectos de Node.js necesitan instalar paquetes tanto del registro público de npm como de tu repositorio de Artifact Registry.
- KEY-FILE es la ruta al archivo de claves JSON de la cuenta de servicio.
Nota: Los ajustes de la configuración que se muestra incluyen una dirección de correo electrónico con marcador de posición. Se requiere una dirección de correo electrónico en la configuración de la Administración de socios de red para publicar paquetes de la Administración de socios de red. Artifact Registry no usa la dirección de correo electrónico con marcador de posición para la autenticación.
Agrega la configuración devuelta al archivo de configuración .npmrc de tus proyectos de Node.js. Por lo general, este archivo se encuentra en el mismo directorio que package.json. Asegúrate de incluir estos parámetros de configuración en los proyectos de Node.js para los paquetes que publiques, así como en los proyectos que instalarán dependencias desde tu repositorio de npm.
Si tienes otros repositorios de Node.js a los que conectarte, repite los pasos anteriores para obtener la configuración y agregarla al archivo .npmrc.