Azure PIM CLI (azpim)

Un outil en ligne de commande pour gérer les activations de rôles Azure Privileged Identity Management (PIM) directement depuis votre terminal.

Fonctionnalités

🔐 Activation de rôles - Activez rapidement les rôles Azure PIM éligibles
🔓 Désactivation de rôles - Désactivez les rôles actifs lorsqu'ils ne sont plus nécessaires
📋 Menu interactif - Interface conviviale pilotée par menus
✨ Interface utilisateur soignée - Expérience terminal élégante avec spinners et couleurs
🔄 Support multi-rôles - Activez ou désactivez plusieurs rôles à la fois
📊 Suivi d'état - Retour en temps réel sur l'état d'activation/désactivation
💾 Préréglages - Sauvegardez et réutilisez des configurations d'activation/désactivation
⭐ Favoris - Marquez des abonnements comme favoris pour un accès rapide
🗃️ Cache des abonnements - Mise en cache automatique des abonnements (durée de vie de 6 heures) pour un démarrage plus rapide
🚀 Mode non interactif - Indicateurs CLI pour les scripts et l'automatisation
🔔 Notifications de mise à jour - Vérifications automatiques des mises à jour avec comportement configurable
📤 Sortie JSON - Sortie lisible par machine pour l'intégration avec d'autres outils
👤 Isolation des données par utilisateur - Configuration et cache stockés par identifiant utilisateur Azure

Prérequis

Avant d'utiliser azpim, assurez-vous d'avoir :

Node.js (v18 ou supérieur)
Azure CLI installé et configuré
Compte Azure avec des rôles éligibles PIM

Configuration d'Azure CLI

# Installer Azure CLI (si non installé)
# Voir : https://docs.microsoft.com/fr-fr/cli/azure/install-azure-cli

# Se connecter à Azure
az login

# Vérifier que vous êtes connecté
az account show

Installation

Installation globale (recommandée)

# Avec npm
npm install -g azpim

# Avec pnpm
pnpm add -g azpim

# Avec yarn
yarn global add azpim

Après l'installation, la commande azpim sera disponible globalement.

Migration depuis azp-cli

Si vous utilisiez auparavant azp-cli, vos préréglages sont stockés dans ~/.config/azp-cli/ (ou %APPDATA%\azp-cli\ sous Windows). Pour migrer :

Copiez votre fichier presets.json vers le nouvel emplacement : ~/.config/azpim/ (ou %APPDATA%\azpim\)
Désinstallez l'ancien paquet : npm uninstall -g azp-cli

Depuis les sources (développement)

# Cloner le dépôt
git clone https://github.com/tapanmeena/azpim.git
cd azpim

# Installer les dépendances
pnpm install

# Compiler le projet
pnpm build

# Lier globalement pour le développement
npm link

Utilisation

Lancer l'interface en ligne de commande

# Après installation globale
azpim

# Ou avec des commandes spécifiques
azpim activate
azpim deactivate
azpim preset list
azpim update

# Mode développement (depuis les sources)
pnpm dev

Commandes

Commande	Alias	Description
`activate`	`a`	Activer un rôle dans Azure PIM (par défaut)
`deactivate`	`d`	Désactiver un rôle dans Azure PIM
`preset`	-	Gérer les préréglages réutilisables
`favorites`	`fav`	Gérer les abonnements favoris
`check-update`	`update`, `upgrade`	Vérifier la disponibilité d'une nouvelle version
`help`	-	Afficher les informations d'aide

Indicateurs globaux :

--debug - Activer les logs de débogage
--version - Afficher le numéro de version

Sous-commandes de préréglage

Commande	Description
`preset list`	Lister tous les préréglages disponibles
`preset show`	Afficher les détails d'un préréglage spécifique
`preset add`	Ajouter un nouveau préréglage (assistant interactif)
`preset edit`	Modifier un préréglage existant (assistant interactif)
`preset remove`	Supprimer un préréglage

Sous-commandes de favoris

Commande	Description
`favorites list`	Lister tous les abonnements favoris
`favorites add`	Ajouter un abonnement aux favoris
`favorites remove`	Supprimer un abonnement des favoris
`favorites clear`	Effacer tous les favoris
`favorites export`	Exporter les favoris vers un fichier
`favorites import`	Importer les favoris depuis un fichier
`favorites refresh`	Actualiser le cache des abonnements

Mises à jour

Vous pouvez vérifier si une nouvelle version est disponible :

azpim update
# alias
azpim upgrade

Remarques :

azpim update se termine avec le code 0 si à jour, 2 si une mise à jour est disponible, et 1 en cas d'erreur.
--check-only - Seulement vérifier et afficher l'état sans montrer les instructions de mise à niveau.
--output json renvoie une réponse structurée adaptée aux scripts.
Par défaut, azpim activate et azpim deactivate afficheront également un bref indicateur de mise à jour disponible (mode texte uniquement) au maximum une fois par jour.
Désactivez les vérifications de mise à jour via AZPIM_NO_UPDATE_NOTIFIER=1 (ou AZPIM_DISABLE_UPDATE_CHECK=1).

Le cache de vérification des mises à jour est stocké avec les préréglages dans votre répertoire de configuration :

macOS/Linux : ~/.config/azpim/update-check.json (ou $XDG_CONFIG_HOME/azpim/update-check.json)
Windows : %APPDATA%\azpim\update-check.json

Mode non interactif (automatisation)

Utilisez des indicateurs pour activer ou désactiver des rôles PIM directement sans passer par le menu interactif, parfait pour les scripts et les workflows CI/CD.

Exemples d'activation

# Activer un seul rôle par nom (non interactif)
azpim activate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Owner" \
   --duration-hours 2 \
   --justification "Intervention d'urgence pour incident" \
   --output json

# Activer plusieurs rôles (répéter --role-name)
azpim activate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Contributor" \
   --role-name "User Access Administrator"

# Si un nom de rôle correspond à plusieurs rôles éligibles (différentes portées),
# --non-interactive générera une erreur sauf si vous autorisez explicitement l'activation de toutes les correspondances
azpim activate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Contributor" \
   --allow-multiple

# Aperçu de ce qui se passerait sans soumettre les demandes
azpim activate --non-interactive --dry-run \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Contributor" \
   --output json

Exemples de désactivation

# Désactiver des rôles spécifiques
azpim deactivate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Owner" \
   --justification "Tâche terminée"

# Désactiver sur tous les abonnements (omettre subscription-id)
azpim deactivate --non-interactive --yes \
   --role-name "Contributor" \
   --allow-multiple

Indicateurs disponibles

Indicateurs communs (activate/deactivate) :

azpim

Populaires