आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
इस पेज पर जाएं
Apigee X दस्तावेज़. जानकारी
Edge API के साथ एसएएमएल का इस्तेमाल करते समय, OAuth2 का ऐक्सेस पाने के लिए इस्तेमाल की जाने वाली प्रोसेस और एसएएमएल दावा के रीफ़्रेश टोकन को पासकोड फ़्लो कहा जाता है. पासवर्ड के साथ तरीका है, तो एक बार इस्तेमाल होने वाला पासवर्ड पाने के लिए ब्राउज़र का इस्तेमाल किया जाता है, जिसका इस्तेमाल आप OAuth2 पाने के लिए कर सकते हैं टोकन.
हालांकि, आपके एनवायरमेंट में सामान्य डेवलपमेंट टास्क के लिए ऑटोमेशन का इस्तेमाल किया जा सकता है, जैसे, टेस्ट ऑटोमेशन या कंटिन्यूअस इंटिग्रेशन/लगातार डिप्लॉयमेंट (सीआई/सीडी). अपने-आप होने के लिए अगर एसएएमएल चालू है, तो आपको OAuth2 टोकन पाने और रीफ़्रेश करने का तरीका जाना होगा, ताकि किसी ब्राउज़र से पासवर्ड कॉपी/पेस्ट करने की ज़रूरत नहीं होती.
मशीन उपयोगकर्ताओं के बारे में जानकारी
Apigee Edge, आपके एसएएमएल की सुविधा वाले संगठन में मशीन उपयोगकर्ताओं के साथ काम करता है. मशीन का इस्तेमाल करने वालों का इस्तेमाल, सिर्फ़ ऑटोमेशन के लिए किया जाता है. इन्हें कोई व्यक्ति सीधे तौर पर ऐक्सेस नहीं करता.
कोई मशीन उपयोगकर्ता OAuth2 टोकन पा सकता है इसके लिए, उस पर पासवर्ड डालने की ज़रूरत नहीं होती. इसका मतलब है कि आप प्रोसेस को पूरी तरह से अपने-आप होने वाले Edge API का इस्तेमाल करके OAuth2 टोकन पाना और उन्हें रीफ़्रेश करना.
टोकन जनरेट करने की प्रोसेस को ऑटोमेट करने का तरीका
टोकन जनरेट करने की प्रोसेस को ऑटोमेट करने के लिए:
चरण | ब्यौरा |
---|---|
1 | अपने एसएएमएल आइडेंटिटी ज़ोन में मशीन उपयोगकर्ता बनाना |
2 | अपने Edge संगठन में मशीन उपयोगकर्ता को ज़रूरी भूमिकाएं असाइन करें |
3 | मशीन के उपयोगकर्ताओं के OAuth2 टोकन पाएं |
वीडियो: मशीन उपयोगकर्ता क्रेडेंशियल का इस्तेमाल करके, Apigee Edge एपीआई का ऐक्सेस अपने-आप होने का तरीका जानने के लिए, यह छोटा सा वीडियो देखें.
एसएएमएल आइडेंटिटी ज़ोन के लिए मशीन उपयोगकर्ता मैनेज करें
Apigee, मशीन उपयोगकर्ता खाते बनाने और उन्हें मैनेज करने के लिए मशीन यूज़र मैनेजमेंट कमांड-लाइन इंटरफ़ेस (सीएलआई) उपलब्ध कराता है. मशीन यूज़र मैनेजमेंट सीएलआई को इस्तेमाल करने का तरीका नीचे बताया गया है.
सीएलआई का इस्तेमाल करें
मशीन यूज़र मैनेजमेंट सीएलआई का इस्तेमाल करने के लिए, सबसे पहले इस फ़ाइल को डाउनलोड करें और अनटार करें:
usermgmt.tar.gz
(1)
सीएलआई को कॉल करने का तरीका इस तरह है:
usermgmt_platform [command] [flags]
नीचे दी गई टेबल में, इस्तेमाल किए जा सकने वाले प्लैटफ़ॉर्म के बारे में खास जानकारी दी गई है. साथ ही, मशीन यूज़र मैनेजमेंट सीएलआई को कॉल करने से जुड़े निर्देश भी दिए गए हैं.
(ये फ़ाइल, usermgmt
डायरेक्ट्री में मौजूद होती हैं.)
प्लैटफ़ॉर्म | 32-बिट | 64-बिट |
---|---|---|
Linux | usermgmt_linux_386 |
usermgmt_linux_amd64 |
Mac | usermgmt_darwin_386 |
usermgmt_darwin_amd64 |
Windows | usermgmt_windows_386 |
usermgmt_windows_amd64 |
नीचे दी गई टेबल में, उन ऑर्डर के बारे में खास जानकारी दी गई है जिनकी जानकारी दी जा सकती है.
इसके अलावा, आप बताए गए निर्देश पर मदद दिखाने के लिए इनमें से एक फ़्लैग पास कर सकते हैं: -h या --help
सीएलआई में साइन इन करें
24 घंटों के अंदर पहली बार सीएलआई चलाने पर, आपको अपने zoneadmin खाते के क्रेडेंशियल डालने के लिए कहा जाएगा.
Enter your Apigee credentials
Username: zoneadmin-username
Password: zoneadmin-password
If your user is opted with MFA, enter MFA code. Otherwise press enter to skip.
MFA: mfa-code_or_enter_to_skip
मशीन यूज़र मैनेजमेंट सीएलआई, आपकी लोकल मशीन पर एक ऐक्सेस टोकन सेव करता है, ताकि आपको 24 घंटे में सिर्फ़ एक बार साइन इन करना पड़े.
सीएलआई का इस्तेमाल करने में मदद पाएं
usermgmt_platform help वाले निर्देश का इस्तेमाल करके, सीएलआई के इस्तेमाल की जानकारी दिखाएं. इस्तेमाल किए जा सकने वाले प्लैटफ़ॉर्म की सूची के लिए, सीएलआई का इस्तेमाल करें देखें.
usermgmt_platform help
सहायता से जुड़ी यह जानकारी दिखती है:
A command-line interface (CLI) to manage machine user accounts to automate
Apigee identity zone management. Use the CLI to create, list, delete,
and reset the password for machine users.
Usage:
usermgmt [flags]
usermgmt [command]
Available Commands:
create Creates a machine users in an identity zone.
delete Deletes a machine users in an identity zone.
help Help about any command
list Lists the machine users in an identity zone.
reset Resets the password for a machine user in an identity zone.
Flags:
-h, --help help for usermgmt
Use "usermgmt [command] --help" for more information about a command.
कमांड लाइन पर निर्देश और -h या --help फ़्लैग, दोनों को पास करके किसी खास निर्देश पर सहायता दिखाएं.
उदाहरण के लिए, सूची आदेश पर सहायता पाने के लिए:
usermgmt_platform list -h
सहायता से जुड़ी यह जानकारी दिखती है:
Lists the machine users in an identity zone.
Usage:
usermgmt list [flags]
Flags:
-h, --help help for list
आइडेंटिटी ज़ोन में मशीन उपयोगकर्ता बनाना
usermgmt_platform create कमांड का इस्तेमाल करके, आइडेंटिटी ज़ोन में मशीन यूज़र बनाएं. इस्तेमाल किए जा सकने वाले प्लैटफ़ॉर्म की सूची के लिए, सीएलआई का इस्तेमाल करें देखें.
- ये निर्देश डालें:
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैusermgmt_platform create
आइडेंटिटी ज़ोन की सूची दिखती है:
myzone1 myzone2
- प्रॉम्प्ट पर ज़ोन का नाम डालें:
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैEnter a zone name: myzone1
- मशीन उपयोगकर्ता के लिए उपयोगकर्ता नाम डालें:
Create a Machine User Username: machineuser1@mycompany.com
- मशीन उपयोगकर्ता के लिए पासवर्ड डालें. जब आपसे कहा जाए, तब पासवर्ड फिर से डालें.
Password: password Re-enter password: password
उपयोगकर्ता बनाया गया है.
Created machine user machineuser1@mycompany.com
सभी मशीन उपयोगकर्ताओं को किसी आइडेंटिटी ज़ोन में शामिल करें
usermgmt_platform list कमांड का इस्तेमाल करके, सभी मशीन उपयोगकर्ताओं को आइडेंटिटी ज़ोन में शामिल करें. इस्तेमाल किए जा सकने वाले प्लैटफ़ॉर्म की सूची के लिए, सीएलआई का इस्तेमाल करें देखें.
- ये निर्देश डालें:
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है आइडेंटिटी ज़ोन की सूची दिखती है:usermgmt_platform list
myzone1 myzone2
- प्रॉम्प्ट पर ज़ोन का नाम डालें:
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैEnter a zone name: myzone1
आइडेंटिटी ज़ोन में मशीन उपयोगकर्ताओं की सूची दिखती है:
Machine users in the zone: machineuser1@mycompany.com
किसी आइडेंटिटी ज़ोन में मशीन उपयोगकर्ता के लिए पासवर्ड रीसेट करना
usermgmt_platform रीसेट करें निर्देश का इस्तेमाल करके, किसी आइडेंटिटी ज़ोन में मशीन उपयोगकर्ता के लिए पासवर्ड रीसेट करें. इस्तेमाल किए जा सकने वाले प्लैटफ़ॉर्म की सूची के लिए, सीएलआई का इस्तेमाल करें देखें.
- ये निर्देश डालें:
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैusermgmt_platform reset
आइडेंटिटी ज़ोन की सूची दिखती है:
myzone1 myzone2
- प्रॉम्प्ट पर ज़ोन का नाम डालें:
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैEnter a zone name: myzone1
- उस मशीन उपयोगकर्ता का उपयोगकर्ता नाम डालें जिसके लिए आपको पासवर्ड रीसेट करना है:
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैReset User Password Enter the username for the machine user Username: machineuser1@mycompany.com
- मशीन उपयोगकर्ता के लिए नया पासवर्ड डालें. जब आपसे कहा जाए, तब पासवर्ड फिर से डालें.
Enter the new password: password Re-enter password: password
पासवर्ड रीसेट कर दिया गया है.
Reset password for machine user machineuser1@mycompany.com
आइडेंटिटी ज़ोन से मशीन उपयोगकर्ता को मिटाना
usermgmt_platform delete कमांड का इस्तेमाल करके, आइडेंटिटी ज़ोन में मौजूद मशीन उपयोगकर्ता को मिटाएं. इस्तेमाल किए जा सकने वाले प्लैटफ़ॉर्म की सूची के लिए, सीएलआई का इस्तेमाल करें देखें.
- ये निर्देश डालें:
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है आइडेंटिटी ज़ोन की सूची दिखती है:usermgmt_platform delete
myzone1 myzone2
- प्रॉम्प्ट पर ज़ोन का नाम डालें:
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैEnter a zone name: myzone1
- मशीन उपयोगकर्ता का वह उपयोगकर्ता नाम डालें जिसे आपको मिटाना है:
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैDelete User Enter the username for the machine user Username: machineuser1@mycompany.com
मशीन उपयोगकर्ता को मिटा दिया गया है.
Deleted user machineuser1@mycompany.com
अपने Edge संगठन में मशीन उपयोगकर्ता को ज़रूरी भूमिकाएं असाइन करें
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, मशीन उपयोगकर्ता को अपने एसएएमएल-चालू किए गए Edge संगठन से जोड़ें और उसे ज़रूरी भूमिकाएं असाइन करें (जैसे कि संगठन का एडमिन), जैसा कि उपयोगकर्ताओं को जोड़ना में बताया गया है.
मशीन के उपयोगकर्ता के OAuth2 टोकन पाएं
टोकन जनरेट करने की प्रोसेस को ऑटोमेट किया जा सकता है. साथ ही, मशीन उपयोगकर्ताओं के लिए टोकन कैश मेमोरी को मैनेज किया जा सकता है.
acurl
(1) और get_token
(1) सुविधाएं, जैसा कि में बताया गया है
मशीन उपयोगकर्ताओं के लिए OAuth2 और एसएएमएल ज़ोन में मशीन उपयोगकर्ता.
curl
के साथ मशीन उपयोगकर्ता के OAuth2 टोकन मैन्युअल रूप से पाने के लिए:
- मशीन उपयोगकर्ता के उपयोगकर्ता नाम और पासवर्ड को कोड में बदलने के लिए अपने पसंदीदा यूआरएल एन्कोडिंग टूल का इस्तेमाल करें.
चेतावनी: यह पक्का करने के लिए कि यूआरएल को
इंटरनल तरीके से एन्कोड करने वाला टूल इस्तेमाल किया जा सकता है कि मशीन उपयोगकर्ता के क्रेडेंशियल से छेड़छाड़ नहीं की जाएगी. - एसएएमएल टोकन एंडपॉइंट को कॉल करके, शुरुआती ऐक्सेस और रीफ़्रेश टोकन जनरेट करें. इसका उदाहरण नीचे दिया गया है:
curl -H "Content-Type: application/x-www-form-urlencoded;charset=utf-8" \ -H "accept: application/json;charset=utf-8" \ -H "Authorization: Basic ZWRnZWNsaTplZGdlY2xpc2VjcmV0" -X POST \ https://zoneName.login.apigee.com/oauth/token -s \ -d 'grant_type=password&username=machineusername&password=machineuserpassword'
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैअनुमति देने के लिए, रिज़र्व किए गए OAuth2 क्लाइंट क्रेडेंशियल,
ZWRnZWNsaTplZGdlY2xpc2VjcmV0
को पास करेंAuthorization
हेडर. कॉल, ऐक्सेस को प्रिंट करता है और टोकन को रीफ़्रेश करता हैstdout
. - ऐक्सेस टोकन को बेयरर हेडर के तौर पर, Edge मैनेजमेंट एपीआई कॉल में पास करें:
curl -H "Authorization: Bearer ACCESS_TOKEN" \ https://api.enterprise.apigee.com/v1/organizations/orgName
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है - ऐक्सेस टोकन की समयसीमा खत्म होने के बाद, एसएएमएल को रीफ़्रेश टोकन भेजकर इसे रीफ़्रेश किया जा सकता है
जैसा कि नीचे दिया गया है:
curl -H "Content-Type:application/x-www-form-urlencoded;charset=utf-8" \ -H "Accept: application/json;charset=utf-8" \ -H "Authorization: Basic ZWRnZWNsaTplZGdlY2xpc2VjcmV0" -X POST \ https://zoneName.login.apigee.com/oauth/token \ -d 'grant_type=refresh_token&refresh_token=REFRESH_TOKEN'
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
(1) कॉपीराइट 2023 Google LLC
usermgmt
, acurl
, और get_token
टूल "सॉफ़्टवेयर" के तौर पर उपलब्ध कराए गए हैं के अंतर्गत
Google Cloud Platform के आपके इस्तेमाल को कंट्रोल करने वाला कानूनी समझौता. इसमें सेवा भी शामिल है
खास शर्तें https://cloud.google.com/terms/service-terms पर उपलब्ध हैं.