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

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 SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD -X POST http://ms_IP:8080/v1/users \
  -d '<User> \
    <FirstName>New</FirstName> \
    <LastName>User</LastName> \
    <Password>NEW_USER_PASSWORD</Password> \
    <EmailId>foo@bar.com</EmailId> \
  </User>'

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

/opt/apigee/apigee-service/bin/apigee-service apigee-provision create-user -f configFile

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

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

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

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD 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 SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD

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

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 SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD

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

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/users/foo@bar.com/userroles

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

curl -X DELETE -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  http://ms_IP:8080/v1/o/org_name/userroles/role/users/foo@bar.com

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

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

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

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

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

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

  1. Edge के यूज़र इंटरफ़ेस (यूआई) या एपीआई में उपयोगकर्ता बनाना.
  2. उपयोगकर्ता को "sysadmin" भूमिका में जोड़ें: 
    curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  -X POST http://ms_IP:8080/v1/userroles/sysadmin/users -d 'id=foo@bar.com'
  3. पक्का करें कि नए उपयोगकर्ता को "sysadmin" की भूमिका मिली हो: 
    curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/userroles/sysadmin/users

    उपयोगकर्ता का ईमेल पता दिखाता है:

    [ " foo@bar.com " ]
  4. नए उपयोगकर्ता की अनुमतियां देखें: 
    curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/users/foo@bar.com/permissions

    वापसी:

    {
  "resourcePermission" : [ {
  "path" : "/",
    "permissions" : [ "get", "put", "delete" ]
  } ]
}
  5. नए सिस्टम एडमिन को जोड़ने के बाद, उपयोगकर्ता को किसी भी संगठन में जोड़ा जा सकता है.
  6. अगर आपको बाद में किसी उपयोगकर्ता को सिस्टम एडमिन की भूमिका से हटाना है, तो इस एपीआई का इस्तेमाल करें: 
    curl -X DELETE -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  http://ms_IP:8080/v1/userroles/sysadmin/users/foo@bar.com

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

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

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

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

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

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD 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=NEW_SYS_ADMIN_EMAIL
APIGEE_ADMINPW=NEW_SYS_ADMIN_PASSWORD
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 CURRENT_SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  http://ms_IP:8080/v1/users/CURRENT_SYS_ADMIN_EMAIL \
  -d '{"emailId": "NEW_SYS_ADMIN_EMAIL", "lastName": "admin", "firstName": "admin"}'
  2. /opt/apigee/customer/defaults.sh फ़ाइल और Edge यूज़र इंटरफ़ेस (यूआई) को अपडेट करने के लिए, पिछली प्रोसेस के दूसरे, तीसरे, और चौथे चरण को दोहराएं.

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

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

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

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

  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 Management Server को रीस्टार्ट करें: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

    अगर अब किसी उपयोगकर्ता को "sysadmin" भूमिका में जोड़ने की कोशिश की जाती है और उस उपयोगकर्ता का ईमेल पता, तय किए गए डोमेन में से किसी एक में नहीं है, तो उसे नहीं जोड़ा जा सकेगा.

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

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

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

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms-IP:8080/v1/users

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

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD -X DELETE http://ms_IP:8080/v1/users/USER_EMAIL