Se connecter à un flux Azure Artifacts - npm

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Azure Artifacts utilise le fichier de configuration .npmrc pour authentifier les clients npm avec des flux. La configuration recommandée conserve la configuration du flux et les informations d’identification dans deux fichiers .npmrc distincts : un fichier au niveau du projet (archivé en même temps que votre package.json) qui stocke l’URL du flux et un fichier au niveau de l’utilisateur (jamais validé) qui stocke vos informations d’identification.

Conditions préalables

Produit	Exigences
Azure DevOps	- Une organisation Azure DevOps . - Un projet Azure DevOps . - Un flux Azure Artifacts. - Téléchargez Node.js et npm.

Se connecter à un flux

Sélectionnez l’onglet qui correspond à votre système d’exploitation et suivez les étapes pour configurer vos fichiers .npmrc :

Remarque

vsts-npm-auth n’est pas pris en charge dans Azure DevOps Server.

Windows
Autres

Connectez-vous à votre organisation Azure DevOps, puis accédez à votre projet.
Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant.
Sélectionnez Se connecter au flux, puis sélectionnez npm dans le volet de navigation gauche.

Si vous n’avez pas installé vsts-npm-auth, exécutez la commande suivante :

npm install -g vsts-npm-auth --registry https://registry.npmjs.com --always-auth false

Ajoutez un fichier .npmrc à votre project dans le même répertoire que votrepackage.json, puis collez l’extrait de code de la section de configuration Project dans le fichier.
Exécutez la commande suivante pour ajouter un jeton à votre fichier .npmrc au niveau de l’utilisateur. npm retourne une erreur 401 non autorisée lorsque le jeton expire, réexécutez cette commande pour l’actualiser.
```
vsts-npm-auth -config .npmrc
```

Connectez-vous à votre organisation Azure DevOps, puis accédez à votre projet.
Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant.
Sélectionnez Se connecter au flux, puis sélectionnez npm dans le volet de navigation gauche.
Ajoutez un fichier .npmrc à votre project dans le même répertoire que votrepackage.json, puis collez l’extrait de code de la section de configuration Project dans le fichier. Votre fichier doit ressembler à ce qui suit :
```
registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
```

Configurer les informations d’identification

Copiez l’extrait de code suivant et collez-le dans votre fichier npmrc de niveau utilisateur :

Flux à l'échelle de l'organisation :

; begin auth token
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
; end auth token

Flux à l'échelle du projet :

; begin auth token
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
; end auth token

Générez un jeton d’accès personnel avec les étendues Gestion des packages,>Lecture & et écriture.
Encodez votre PAT en base64 à l’aide de l’une des méthodes suivantes :
- Node.js (toutes les plateformes) : exécutez la commande suivante, entrez votre mot de passe lorsque vous y êtes invité et copiez la valeur résultante.
```
node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"
```
- macOS ou Linux : exécutez la commande suivante et copiez la sortie.
```
echo -n "YOUR_PERSONAL_ACCESS_TOKEN" | base64
```
Remplacez les marqueurs [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] dans votre fichier .npmrc utilisateur par la valeur encodée.

Windows
Autres

Connectez-vous à votre collection Azure DevOps, puis accédez à votre projet.
Sélectionnez Artefacts, sélectionnez votre flux dans le menu déroulant, puis sélectionnez Se connecter au flux.
Sélectionnez npm, puis suivez les étapes de la section d’installation de Project pour configurer votre fichier .npmrc et vous authentifier auprès de votre flux.

Connectez-vous à votre collection Azure DevOps, puis accédez à votre projet.
Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant.
Sélectionnez Se connecter au flux, puis sélectionnez npm dans le volet de navigation gauche.
Ajoutez un fichier .npmrc à votre project dans le même répertoire que votrepackage.json, puis collez l’extrait de code de la section de configuration Project dans le fichier. Votre fichier doit ressembler à ce qui suit :
```
registry=http://<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/
```

Configurer les informations d’identification

Copiez l’extrait de code suivant et collez-le dans votre fichier .npmrc de niveau utilisateur :

Flux à portée de collection :

; begin auth token
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=DefaultCollection
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:username=DefaultCollection
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
; end auth token

Flux à l'échelle du projet :

; begin auth token
//<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
//<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
//<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
//<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
; end auth token

Générez un jeton d’accès personnel avec les étendues Gestion des packages,>Lecture & et écriture.

Exécutez la commande suivante, entrez votre PAT lorsque vous y êtes invité, puis copiez la valeur encodée en Base64 résultante.

node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"

Remplacez les marqueurs [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] dans votre fichier .npmrc utilisateur par la valeur encodée.

Conseil

L'utilisation de plusieurs registres dans les fichiers .npmrc est possible grâce à des espaces de nommage et des sources en amont.

Commentaires

Cette page a-t-elle été utile ?

Dernière mise à jour : 2026-08-28

Se connecter à un flux Azure Artifacts - npm

Conditions préalables

Se connecter à un flux

Contenu connexe

Commentaires

Ressources supplémentaires