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

Edge for Private Cloud v. 4.17.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 कमांड का इस्तेमाल करें:

> /opt/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 -X POST -H "Content-Type: application/xml" /
http://<ms_IP>:8080/v1/o/<org_name>/users/foo@bar.com/userroles /
-d '<Roles><Role name="role"/></Roles>' /
-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 इंस्टॉल करते समय, आपको सिस्टम एडमिन का ईमेल पता डालना होता है. Edge, उस ईमेल पते से एक उपयोगकर्ता बनाता है और उसे डिफ़ॉल्ट सिस्टम एडमिन के तौर पर सेट करता है. ऊपर बताए गए तरीके से, बाद में अन्य सिस्टम एडमिन जोड़े जा सकते हैं.

इस सेक्शन में, डिफ़ॉल्ट सिस्टम एडमिन को बदलकर किसी दूसरे उपयोगकर्ता को सिस्टम एडमिन बनाने का तरीका बताया गया है. साथ ही, मौजूदा डिफ़ॉल्ट सिस्टम एडमिन के उपयोगकर्ता खाते का ईमेल पता बदलने का तरीका बताया गया है.

सिस्टम एडमिन के तौर पर कॉन्फ़िगर किए गए उपयोगकर्ताओं की सूची देखने के लिए, यहां दिए गए एपीआई कॉल का इस्तेमाल करें:

curl -u sysAdminEmail:passwd http://<ms_IP>:8080/v1/userroles/sysadmin/users

मौजूदा डिफ़ॉल्ट सिस्टम एडमिन का पता लगाने के लिए, /opt/apigee/customer/defaults.sh फ़ाइल देखें. फ़ाइल में यह लाइन शामिल है, जिसमें मौजूदा डिफ़ॉल्ट सिस्टम एडमिन का ईमेल पता दिखता है:

ADMIN_EMAIL=foo@bar.com

डिफ़ॉल्ट सिस्टम एडमिन को बदलकर किसी दूसरे उपयोगकर्ता को एडमिन बनाने के लिए:

  1. ऊपर बताए गए तरीके से नया सिस्टम एडमिन बनाएं या पक्का करें कि नए सिस्टम एडमिन का उपयोगकर्ता खाता, पहले से ही सिस्टम एडमिन के तौर पर कॉन्फ़िगर किया गया हो.
  2. /opt/apigee/customer/defaults.sh में बदलाव करके, ADMIN_EMAIL को नए सिस्टम एडमिन के ईमेल पते पर सेट करें.
  3. Edge यूज़र इंटरफ़ेस (यूआई) को इंस्टॉल करने के लिए इस्तेमाल की गई साइलेंट कॉन्फ़िगरेशन फ़ाइल में बदलाव करें, ताकि ये प्रॉपर्टी सेट की जा सकें:
    ADMIN_EMAIL=emailAddressOfNewSysAdmin
    APIGEE_ADMINPW=pwOfNewSysAdmin
    SMTPHOST=smtp.gmail.com
    SMTPPORT=465
    SMTPUSER=foo@gmail.com
    SMTPPASSWORD=bar
    SMTPSSL=y
    ध्यान दें कि आपको एसएमटीपी प्रॉपर्टी शामिल करनी होंगी, क्योंकि यूज़र इंटरफ़ेस (यूआई) की सभी प्रॉपर्टी रीसेट हो जाती हैं.
  4. Edge यूज़र इंटरफ़ेस (यूआई) को फिर से कॉन्फ़िगर करें:
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui stop
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui start

अगर आपको मौजूदा डिफ़ॉल्ट सिस्टम एडमिन के उपयोगकर्ता खाते का ईमेल पता बदलना है, तो पहले उपयोगकर्ता खाते को अपडेट करके नया ईमेल पता सेट करें. इसके बाद, डिफ़ॉल्ट सिस्टम एडमिन का ईमेल पता बदलें:

  1. मौजूदा डिफ़ॉल्ट सिस्टम एडमिन के उपयोगकर्ता खाते को नए ईमेल पते से अपडेट करें:
    > curl -H content-type:application/json -X PUT /
    -u currentSysAdminEmail:passwd /
    http://<ms_IP>:8080/v1/users/currentSysAdminEmail /
    -d '{"emailId": "newSysAdminEmail", "lastName": "admin", "firstName": "admin"}'
  2. /opt/apigee/customer/defaults.sh फ़ाइल और Edge यूज़र इंटरफ़ेस (यूआई) को अपडेट करने के लिए, पिछली प्रोसेस के दूसरे, तीसरे, और चौथे चरण को दोहराएं.

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

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

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

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

  1. किसी एडिटर में management-server.properties खोलें:
    vi /opt/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 मैनेजमेंट सर्वर को रीस्टार्ट करें:
    /opt/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>