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

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

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

उपयोगकर्ताओं को मैनेज करने के लिए, आपको सिस्टम एडमिन के अधिकार चाहिए. Edge के क्लाउड-आधारित इंस्टॉलेशन में, Apigee सिस्टम एडमिन की भूमिका निभाता है. Edge for the 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 के इंस्टॉलेशन में, राऊटर, मैसेज प्रोसेसर, और अन्य कॉम्पोनेंट जोड़ना
  • TLS/SSL कॉन्फ़िगर करना
  • अतिरिक्त सिस्टम एडमिन बनाना
  • Edge के एडमिन से जुड़े सभी टास्क पूरे करना

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

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

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

  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

    ध्यान दें कि आपको SMTP प्रॉपर्टी शामिल करनी होंगी, क्योंकि नए Edge यूज़र इंटरफ़ेस (यूआई) की सभी प्रॉपर्टी रीसेट हो जाती हैं.

  4. नए Edge यूज़र इंटरफ़ेस (यूआई) को फिर से कॉन्फ़िगर करें: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-management-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. नए Edge यूज़र इंटरफ़ेस (यूआई) को अपडेट करने के लिए, पिछली प्रोसेस के चरण 2, 3, और 4 दोहराएं ताकि /opt/apigee/customer/defaults.sh फ़ाइल अपडेट हो जाए.

सिस्टम एडमिन का ईमेल डोमेन तय करना

सुरक्षा का एक और लेवल जोड़ने के लिए, 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 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