Azure PIM CLI (azpim)

एक कमांड-लाइन इंटरफ़ेस टूल जो आपके टर्मिनल से सीधे Azure प्रिविलेज्ड आइडेंटिटी मैनेजमेंट (PIM) भूमिका सक्रियण प्रबंधित करने के लिए है।

विशेषताएं

• 🔐 भूमिका सक्रियण - पात्र Azure PIM भूमिकाओं को तुरंत सक्रिय करें
• 🔓 भूमिका निष्क्रियण - जब आवश्यकता न हो तो सक्रिय भूमिकाओं को निष्क्रिय करें
• 📋 इंटरैक्टिव मेनू - उपयोगकर्ता-अनुकूल मेनू-संचालित इंटरफ़ेस
• ✨ सुंदर UI - स्पिनरों और रंगों के साथ पॉलिश टर्मिनल अनुभव
• 🔄 मल्टी-रोल सपोर्ट - एक साथ कई भूमिकाओं को सक्रिय या निष्क्रिय करें
• 📊 स्थिति ट्रैकिंग - सक्रियण/निष्क्रियण स्थिति पर रीयल-टाइम फीडबैक
• 💾 प्रीसेट - सक्रियण/निष्क्रियण कॉन्फ़िगरेशन सहेजें और पुनः उपयोग करें
• ⭐ पसंदीदा - त्वरित पहुंच के लिए सब्सक्रिप्शन को पसंदीदा के रूप में चिह्नित करें
• 🗃️ सब्सक्रिप्शन कैश - तेज़ स्टार्टअप के लिए स्वचालित सब्सक्रिप्शन कैशिंग (6 घंटे TTL)
• 🚀 गैर-इंटरैक्टिव मोड - स्क्रिप्टिंग और ऑटोमेशन के लिए CLI फ़्लैग
• 🔔 अपडेट सूचनाएं - कॉन्फ़िगरेबल व्यवहार के साथ स्वचालित अपडेट जांच
• 📤 JSON आउटपुट - अन्य टूल्स के साथ एकीकरण के लिए मशीन-पठनीय आउटपुट
• 👤 प्रति-उपयोगकर्ता डेटा अलगाव - कॉन्फ़िगरेशन और कैश प्रति Azure उपयोगकर्ता ID में संग्रहीत

पूर्वापेक्षाएँ

azpim का उपयोग करने से पहले, सुनिश्चित करें कि आपके पास:

1. Node.js (v18 या उच्चतर)
2. Azure CLI स्थापित और कॉन्फ़िगर
3. Azure खाता PIM-पात्र भूमिकाओं के साथ

Azure CLI सेटअप

# Azure CLI स्थापित करें (यदि स्थापित नहीं है)
# देखें: https://docs.microsoft.com/en-us/cli/azure/install-azure-cli

# Azure में लॉगिन करें
az login

# सत्यापित करें कि आप लॉग इन हैं
az account show

स्थापना

वैश्विक स्थापना (अनुशंसित)

# npm का उपयोग करके
npm install -g azpim

# pnpm का उपयोग करके
pnpm add -g azpim

# yarn का उपयोग करके
yarn global add azpim

स्थापना के बाद, azpim कमांड वैश्विक रूप से उपलब्ध होगा।

azp-cli से माइग्रेट करना

यदि आपने पहले azp-cli का उपयोग किया था, तो आपके प्रीसेट ~/.config/azp-cli/ में संग्रहीत हैं (Windows पर %APPDATA%\azp-cli\ देखें)। माइग्रेट करने के लिए:

1. अपनी presets.json को नए स्थान पर कॉपी करें: ~/.config/azpim/ (या Windows पर %APPDATA%\azpim\)
2. पुराने पैकेज को अनइंस्टॉल करें: npm uninstall -g azp-cli

स्रोत से (डेवलपमेंट)

# रिपॉजिटरी को क्लोन करें
git clone https://github.com/tapanmeena/azpim.git
cd azpim

# निर्भरताएं स्थापित करें
pnpm install

# प्रोजेक्ट बनाएं
pnpm build

# डेवलपमेंट के लिए वैश्विक रूप से लिंक करें
npm link

उपयोग

CLI चलाना

# वैश्विक स्थापना के बाद
azpim

# या विशिष्ट कमांड के साथ
azpim activate
azpim deactivate
azpim preset list
azpim update

# डेवलपमेंट मोड (स्रोत से)
pnpm dev

कमांड

कमांड	उपनाम	विवरण
activate	a	Azure PIM में भूमिका सक्रिय करें (डिफ़ॉल्ट)
deactivate	d	Azure PIM में भूमिका निष्क्रिय करें
preset	-	पुन: प्रयोज्य प्रीसेट प्रबंधित करें
favorites	fav	पसंदीदा सब्सक्रिप्शन प्रबंधित करें
check-update	update, upgrade	नया वर्ज़न उपलब्ध है या नहीं जांचें
help	-	सहायता जानकारी प्रदर्शित करें

वैश्विक फ़्लैग:

• --debug - डीबग लॉगिंग सक्षम करें
• --version - वर्ज़न नंबर दिखाएं

प्रीसेट उपकमांड

कमांड	विवरण
preset list	सभी उपलब्ध प्रीसेट सूचीबद्ध करें
preset show	किसी विशिष्ट प्रीसेट का विवरण दिखाएं
preset add	नया प्रीसेट जोड़ें (इंटरैक्टिव विज़ार्ड)
preset edit	मौजूदा प्रीसेट संपादित करें (इंटरैक्टिव विज़ार्ड)
preset remove	प्रीसेट हटाएं

पसंदीदा उपकमांड

कमांड	विवरण
favorites list	सभी पसंदीदा सब्सक्रिप्शन सूचीबद्ध करें
favorites add	सब्सक्रिप्शन को पसंदीदा में जोड़ें
favorites remove	सब्सक्रिप्शन को पसंदीदा से हटाएं
favorites clear	सभी पसंदीदा साफ़ करें
favorites export	पसंदीदा को फ़ाइल में निर्यात करें
favorites import	फ़ाइल से पसंदीदा आयात करें
favorites refresh	सब्सक्रिप्शन कैश रिफ्रेश करें

अपडेट

आप जांच सकते हैं कि कोई नया वर्ज़न उपलब्ध है या नहीं:

azpim update
# उपनाम
azpim upgrade

नोट्स:

• azpim update अप-टू-डेट होने पर कोड 0 के साथ, अपडेट उपलब्ध होने पर 2 के साथ और त्रुटि पर 1 के साथ बाहर निकलता है।
• --check-only - अपग्रेड निर्देश दिखाए बिना केवल स्थिति की जांच करें और प्रिंट करें।
• --output json स्क्रिप्ट के लिए उपयुक्त एक संरचित प्रतिक्रिया लौटाता है।
• डिफ़ॉल्ट रूप से, azpim activate और azpim deactivate दिन में अधिकतम एक बार एक छोटा "अपडेट उपलब्ध" संकेत (टेक्स्ट मोड में) भी दिखाएंगे।
• AZPIM_NO_UPDATE_NOTIFIER=1 (या AZPIM_DISABLE_UPDATE_CHECK=1) के माध्यम से अपडेट जांच अक्षम करें।

अपडेट-चेक कैश आपके कॉन्फ़िगरेशन निर्देशिका में प्रीसेट के साथ संग्रहीत है:

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

गैर-इंटरैक्टिव मोड (ऑटोमेशन)

इंटरैक्टिव मेनू से गुज़रे बिना सीधे PIM भूमिकाओं को सक्रिय या निष्क्रिय करने के लिए फ़्लैग का उपयोग करें, स्क्रिप्टिंग और CI/CD वर्कफ़्लो के लिए एकदम सही।

सक्रियण उदाहरण

# नाम से एकल भूमिका सक्रिय करें (गैर-इंटरैक्टिव)
azpim activate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Owner" \
   --duration-hours 2 \
   --justification "Break-glass for incident" \
   --output json

# एकाधिक भूमिकाएं सक्रिय करें (--role-name दोहराएं)
azpim activate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Contributor" \
   --role-name "User Access Administrator"

# यदि कोई भूमिका नाम कई पात्र भूमिकाओं (विभिन्न स्कोप) से मेल खाता है,
# तो --non-interactive त्रुटि देगा जब तक कि आप स्पष्ट रूप से सभी मिलानों को सक्रिय करने की अनुमति न दें
azpim activate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Contributor" \
   --allow-multiple

# अनुरोध सबमिट किए बिना पूर्वावलोकन करें कि क्या होगा
azpim activate --non-interactive --dry-run \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Contributor" \
   --output json

निष्क्रियण उदाहरण

# विशिष्ट भूमिकाओं को निष्क्रिय करें
azpim deactivate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Owner" \
   --justification "Task completed"

# सभी सब्सक्रिप्शन में निष्क्रिय करें (subscription-id छोड़ें)
azpim deactivate --non-interactive --yes \
   --role-name "Contributor" \
   --allow-multiple

उपलब्ध फ़्लैग

सामान्य फ़्लैग (सक्रियण/निष्क्रियण):

• --non-interactive - इंटरैक्टिव प्रॉम्प्ट अक्षम करें
• -y, --yes - पुष्टिकरण प्रॉम्प्ट छोड़ें
• --subscription-id <id> - लक्ष्य सब्सक्रिप्शन (निष्क्रियण के लिए वैकल्पिक)
• --role-name <name> - लक्ष्य भूमिका नाम (दोहराया जा सकता है)
• --allow-multiple - एकाधिक भूमिका मिलान की अनुमति दें
• --dry-run - सबमिट किए बिना पूर्वावलोकन
• --output <text|json> - आउटपुट प्रारूप (डिफ़ॉल्ट: text)
• --quiet - गैर-आवश्यक आउटपुट दबाएं

सक्रियण-विशिष्ट:

• --duration-hours <n> - अवधि (1-8 घंटे, भूमिका के अनुसार डिफ़ॉल्ट भिन्न)
• --justification <text> - सक्रियण के लिए औचित्य

निष्क्रियण-विशिष्ट:

• --justification <text> - निष्क्रियण के लिए औचित्य (वैकल्पिक)

प्रीसेट