उपयोगकर्ताओं, भूमिकाओं, और अनुमतियों को मैनेज करना

Edge for Private Cloud v. 4.16.05

Apigee के दस्तावेज़ वाली साइट पर, उपयोगकर्ता की भूमिकाओं और अनुमतियों को मैनेज करने के बारे में ज़्यादा जानकारी दी गई है. उपयोगकर्ताओं को Edge यूज़र इंटरफ़ेस (यूआई) और Management API, दोनों का इस्तेमाल करके मैनेज किया जा सकता है. हालांकि, भूमिकाओं और अनुमतियों को सिर्फ़ Management API से मैनेज किया जा सकता है.

उपयोगकर्ताओं और उपयोगकर्ता बनाने के बारे में जानकारी के लिए, यहां जाएं:

• ग्लोबल उपयोगकर्ताओं के बारे में जानकारी
• ग्लोबल उपयोगकर्ताओं की प्रोफ़ाइल बनाना

उपयोगकर्ताओं को मैनेज करने के लिए की जाने वाली कई कार्रवाइयों के लिए, सिस्टम एडमिन के अधिकारों की ज़रूरत होती है. Edge के क्लाउड आधारित इंस्टॉलेशन में, Apigee सिस्टम एडमिन के तौर पर काम करता है. Edge for Private Cloud को इंस्टॉल करने के लिए, आपके सिस्टम एडमिन को यहां बताए गए टास्क पूरे करने होंगे.

उपयोगकर्ता जोड़ रहे हैं

Edge API, Edge यूज़र इंटरफ़ेस (यूआई) या Edge कमांड का इस्तेमाल करके, उपयोगकर्ता बनाया जा सकता है. इस सेक्शन में, Edge API और Edge कमांड इस्तेमाल करने का तरीका बताया गया है. Edge यूज़र इंटरफ़ेस (यूआई) में उपयोगकर्ता बनाने के बारे में जानकारी पाने के लिए, ग्लोबल उपयोगकर्ता बनाना लेख पढ़ें.

किसी संगठन में उपयोगकर्ता को जोड़ने के बाद, आपको उसे कोई भूमिका असाइन करनी होगी. भूमिकाओं से यह तय होता है कि Edge पर उपयोगकर्ता के पास किस तरह के ऐक्सेस अधिकार हैं.

Edge API का इस्तेमाल करके उपयोगकर्ता बनाने के लिए, इस निर्देश का इस्तेमाल करें:

curl -H "Content-Type:application/xml" -u <sysAdminEmail>:<passwd> \
-X POST http://<ms_IP>:8080/v1/users \
-d '<User> \
   <FirstName>New</FirstName> \
   <LastName>User</LastName> \
   <Password>newUserPWord</Password> \
   <EmailId>foo@bar.com</EmailId> \
</User>'

इसके अलावा, उपयोगकर्ता बनाने के लिए इस Edge कमांड का इस्तेमाल करें:

> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision create-user -f configFile

जहां configFile में उपयोगकर्ता बनाने के लिए ज़रूरी जानकारी शामिल हो:

APIGEE_ADMINPW=sysAdminPW    # If omitted, you will be prompted.
USER_NAME=foo@bar.com
FIRST_NAME=New
LAST_NAME=User
USER_PWD="newUserPWord"
ORG_NAME=myorg  

इसके बाद, उपयोगकर्ता के बारे में जानकारी देखने के लिए, इस कॉल का इस्तेमाल किया जा सकता है:

curl -u <sysAdminEmail>:<passwd> http://<ms_IP>:8080/v1/users/foo@bar.com

किसी संगठन में उपयोगकर्ता को कोई भूमिका असाइन करना

किसी नए उपयोगकर्ता को कोई भी काम करने से पहले, संगठन में कोई भूमिका असाइन की जानी चाहिए. उपयोगकर्ता को अलग-अलग भूमिकाएं असाइन की जा सकती हैं. जैसे: orgadmin, businessuser, opsadmin, user या संगठन में तय की गई कोई कस्टम भूमिका.

किसी उपयोगकर्ता को संगठन में कोई भूमिका असाइन करने पर, वह उपयोगकर्ता संगठन में अपने-आप जुड़ जाता है. किसी उपयोगकर्ता को एक से ज़्यादा संगठनों में असाइन करने के लिए, उसे हर संगठन में कोई भूमिका असाइन करें.

किसी संगठन में उपयोगकर्ता को कोई भूमिका असाइन करने के लिए, इस निर्देश का इस्तेमाल करें:

curl -X POST -H "Content-Type:application/x-www-form-urlencoded" /
http://<ms_IP>:8080/v1/o/<org_name>/userroles/<role>/users?id=foo@bar.com /
-u <sysAdminEmail>:<passwd> 

उपयोगकर्ता की भूमिकाएं देखने के लिए, इस कमांड का इस्तेमाल करें:

curl -u <sysAdminEmail>:<passwd> /
http://<ms_IP>:8080/v1/users/foo@bar.com/userroles

किसी उपयोगकर्ता को संगठन से हटाने के लिए, उस संगठन में उपयोगकर्ता की सभी भूमिकाएं हटाएं. किसी उपयोगकर्ता से कोई भूमिका हटाने के लिए, इस कमांड का इस्तेमाल करें:

curl -X DELETE -u <sysAdminEmail>:<passwd> http://<ms_IP>:8080/v1/o/<org_name>/userroles/<role>/users/foo@bar.com

सिस्टम एडमिन जोड़ना

सिस्टम एडमिन ये काम कर सकता है:

• संगठन बनाएं
• Edge इंस्टॉलेशन में राऊटर, मैसेज प्रोसेसर, और अन्य कॉम्पोनेंट जोड़ना
• टीएलएस/एसएसएल कॉन्फ़िगर करना
• अन्य सिस्टम एडमिन बनाना
• Edge से जुड़े, एडमिन के सभी काम पूरे करना

एडमिन के टास्क के लिए, सिर्फ़ एक उपयोगकर्ता ही डिफ़ॉल्ट उपयोगकर्ता होता है. हालांकि, एक से ज़्यादा सिस्टम एडमिन हो सकते हैं. sysadmin की भूमिका वाले किसी भी उपयोगकर्ता के पास सभी संसाधनों के लिए पूरी अनुमतियां होती हैं.

सिस्टम एडमिन के लिए उपयोगकर्ता को Edge यूज़र इंटरफ़ेस (यूआई) या एपीआई, दोनों में से किसी एक में बनाया जा सकता है. हालांकि, उपयोगकर्ता को sysadmin की भूमिका असाइन करने के लिए, आपको Edge API का इस्तेमाल करना होगा. Edge के यूज़र इंटरफ़ेस (यूआई) में, किसी उपयोगकर्ता को sysadmin की भूमिका असाइन नहीं की जा सकती.

सिस्टम एडमिन जोड़ने के लिए:

1. Edge के यूज़र इंटरफ़ेस (यूआई) या एपीआई में उपयोगकर्ता बनाना.
2. उपयोगकर्ता को sysadmin की भूमिका में जोड़ें:
   curl -u <sysAdminEmail>:<passwd> \
   -X POST http://<ms_IP>:8080/v1/userroles/sysadmin/users \
   -d 'id=foo@bar.com'
3. पक्का करें कि नए उपयोगकर्ता को सिस्टम एडमिन की भूमिका असाइन की गई हो:
   curl -u <sysAdminEmail>:<passwd> http://<ms_IP>:8080/v1/userroles/sysadmin/users
   
   उपयोगकर्ता का ईमेल पता दिखाता है:
   [ " foo@bar.com " ]
4. नए उपयोगकर्ता की अनुमतियां देखें:
   curl -u <sysAdminEmail>:<passwd> http://<ms_IP>:8080/v1/users/foo@bar.com/permissions
   
   यह दिखाता है:
   {
   "resourcePermission" : [ {
   "path" : "/",
   "permissions" : [ "get", "put", "delete" ]
   } ]
   }
5. नए सिस्टम एडमिन को जोड़ने के बाद, उपयोगकर्ता को किसी भी संगठन में जोड़ा जा सकता है.
   ध्यान दें: नया सिस्टम एडमिन, Edge यूज़र इंटरफ़ेस (यूआई) में तब तक लॉग इन नहीं कर सकता, जब तक उसे कम से कम एक संगठन में न जोड़ा जाए.
6. अगर आपको बाद में किसी उपयोगकर्ता को सिस्टम एडमिन की भूमिका से हटाना है, तो इस एपीआई का इस्तेमाल करें:
   curl -X DELETE -u <sysadminEmail:pword>
   http://<ms_IP>:8080/v1/userroles/sysadmin/users/foo@bar.com
   
   ध्यान दें कि यह कॉल, उपयोगकर्ता को सिर्फ़ उसकी भूमिका से हटाता है, उसे मिटाता नहीं है.

सिस्टम एडमिन के ईमेल डोमेन की जानकारी देना

सुरक्षा के अतिरिक्त लेवल के तौर पर, Edge सिस्टम एडमिन के लिए ज़रूरी ईमेल डोमेन तय किया जा सकता है. सिस्टम एडमिन को जोड़ते समय, अगर उपयोगकर्ता का ईमेल पता तय किए गए डोमेन में नहीं है, तो उपयोगकर्ता को sysadmin की भूमिका में नहीं जोड़ा जा सकता.

डिफ़ॉल्ट रूप से, ज़रूरी डोमेन फ़ील्ड खाली होता है. इसका मतलब है कि sysadmin की भूमिका के लिए, किसी भी ईमेल पते को जोड़ा जा सकता है.

ईमेल डोमेन सेट करने के लिए:

1. किसी एडिटर में management-server.properties खोलें:
   vi /<inst_root>/apigee/customer/application/management-server.properties
   
   अगर यह फ़ाइल मौजूद नहीं है, तो इसे बनाएं.
2. conf_security_rbac.global.roles.allowed.domains प्रॉपर्टी को, अनुमति वाले डोमेन की कॉमा लगाकर अलग की गई सूची पर सेट करें. उदाहरण के लिए:
   conf_security_rbac.global.roles.allowed.domains=myCo.com,yourCo.com
3. बदलावों को सेव करें.
4. Edge Management Server को रीस्टार्ट करें:
   /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server restart
   
   अगर अब किसी उपयोगकर्ता को सिस्टम एडमिन की भूमिका में जोड़ने की कोशिश की जाती है और उपयोगकर्ता का ईमेल पता, बताए गए डोमेन में से किसी एक में नहीं है, तो उसे नहीं जोड़ा जा सकता.

किसी उपयोगकर्ता को मिटाना

Edge API या Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, उपयोगकर्ता बनाया जा सकता है. हालांकि, एपीआई का इस्तेमाल करके ही किसी उपयोगकर्ता को मिटाया जा सकता है.

मौजूदा उपयोगकर्ताओं की सूची देखने के लिए, नीचे दिए गए cURL कमांड का इस्तेमाल करें. इस सूची में उपयोगकर्ताओं के ईमेल पते भी शामिल होते हैं:

curl -u <sysAdminEmail>:<passwd> http://<ms-IP>:8080/v1/users

किसी उपयोगकर्ता को मिटाने के लिए, इस cURL कमांड का इस्तेमाल करें:

curl -u <sysAdminEmail>:<passwd> -X DELETE http://<ms-IP>:8080/v1/users/<userEmail>