Kullanıcıları, rolleri ve izinleri yönetme

Apigee dokümanlar sitesinde, kullanıcı rollerini ve izinlerini yönetme hakkında kapsamlı bilgiler bulunur. Kullanıcılar hem yeni Edge kullanıcı arayüzü hem de Management API kullanılarak yönetilebilir. Roller ve izinler yalnızca Management API ile yönetilebilir.

Kullanıcılar ve kullanıcı oluşturma hakkında bilgi edinmek için aşağıdaki makaleleri inceleyin:

Kullanıcıları yönetmek için gerçekleştirdiğiniz işlemlerin çoğu sistem yöneticisi ayrıcalıkları gerektirir. Edge'in bulut tabanlı bir kurulumunda Apigee, sistem yöneticisi rolünde işlev görür. Edge for Private Cloud kurulumunda, sistem yöneticinizin bu görevleri aşağıda açıklandığı şekilde gerçekleştirmesi gerekir.

Kullanıcı ekleme

Kullanıcıyı Edge API'yi, yeni Edge kullanıcı arayüzünü veya Edge komutlarını kullanarak oluşturabilirsiniz. Bu bölümde, Edge API ve Edge komutlarının nasıl kullanılacağı açıklanmaktadır. Yeni Edge kullanıcı arayüzünde kullanıcı oluşturma hakkında bilgi için Genel kullanıcı oluşturma başlıklı makaleyi inceleyin.

Kullanıcıyı bir kuruluşta oluşturduktan sonra kullanıcıya bir rol atamanız gerekir. Roller, kullanıcının Edge'deki erişim haklarını belirler.

Edge API ile kullanıcı oluşturmak için aşağıdaki komutu kullanın:

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>'

Alternatif olarak, kullanıcı oluşturmak için aşağıdaki Edge komutunu kullanın:

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

Aşağıdaki örnekte gösterildiği gibi, configFile kullanıcıyı oluşturur:

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

Ardından, bu aramayı kullanarak kullanıcıyla ilgili bilgileri görüntüleyebilirsiniz:

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

Kullanıcıyı bir kuruluştaki role atama

Yeni bir kullanıcının herhangi bir işlem yapabilmesi için kuruluştaki bir role atanması gerekir. Kullanıcıyı orgadmin, businessuser, opsadmin, user gibi farklı rollere veya kuruluşta tanımlanmış özel bir role atayabilirsiniz.

Bir kuruluştaki role kullanıcı atadığınızda bu kullanıcı otomatik olarak kuruluşa eklenir. Kullanıcıyı her kuruluştaki bir role atayarak birden fazla kuruluşa atayın.

Kullanıcıyı bir kuruluştaki role atamak için aşağıdaki komutu kullanın:

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

Bu çağrı, kullanıcıya atanan tüm rolleri gösterir. Kullanıcıyı eklemek ancak yalnızca yeni rolü göstermek istiyorsanız aşağıdaki çağrıyı kullanın:

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

Aşağıdaki komutu kullanarak kullanıcının rollerini görüntüleyebilirsiniz:

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

Bir kullanıcıyı kuruluştan kaldırmak için kullanıcının kuruluştaki tüm rollerini kaldırın. Bir kullanıcıdan rol kaldırmak için aşağıdaki komutu kullanın:

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

Sistem yöneticisi ekleme

Sistem yöneticisi şunları yapabilir:

  • Kuruluş oluşturma
  • Edge kurulumuna yönlendiriciler, mesaj işlemciler ve diğer bileşenleri ekleme
  • TLS/SSL'yi yapılandırma
  • Ek sistem yöneticileri oluşturma
  • Tüm Edge yönetim görevlerini gerçekleştirme

Yönetim görevleri için varsayılan kullanıcı yalnızca bir kişi olsa da birden fazla sistem yöneticisi olabilir. "sysadmin" rolünün üyesi olan tüm kullanıcılar, tüm kaynaklar için tam izinlere sahiptir.

Sistem yöneticisi için kullanıcıyı Yeni Edge kullanıcı arayüzünde veya API'de oluşturabilirsiniz. Ancak kullanıcıyı "sysadmin" rolüne atamak için Edge API'yi kullanmanız gerekir. Yeni Edge kullanıcı arayüzünde bir kullanıcıya "sysadmin" rolü atanamaz.

Sistem yöneticisi eklemek için:

  1. Yeni Edge kullanıcı arayüzünde veya API'de kullanıcı oluşturun.
  2. Kullanıcıyı "sysadmin" rolüne ekleyin: 
    curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  -X POST http://ms_IP:8080/v1/userroles/sysadmin/users -d 'id=foo@bar.com'
  3. Yeni kullanıcının "sysadmin" rolünde olduğundan emin olun: 
    curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/userroles/sysadmin/users

    Kullanıcının e-posta adresini döndürür:

    [ " foo@bar.com " ]
  4. Yeni kullanıcının izinlerini kontrol etme: 
    curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/users/foo@bar.com/permissions

    Şunu döndürür:

    {
  "resourcePermission" : [ {
  "path" : "/",
    "permissions" : [ "get", "put", "delete" ]
  } ]
}
  5. Yeni sistem yöneticisini ekledikten sonra kullanıcıyı istediğiniz kuruluşa ekleyebilirsiniz.
  6. Kullanıcıyı daha sonra sistem yöneticisi rolünden kaldırmak isterseniz aşağıdaki API'yi kullanabilirsiniz: 
    curl -X DELETE -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  http://ms_IP:8080/v1/userroles/sysadmin/users/foo@bar.com

    Bu işlevin yalnızca kullanıcıyı rolden kaldırdığını, silmediğini unutmayın.

Varsayılan sistem yöneticisi kullanıcısını değiştirme

Edge'i yüklediğiniz sırada sistem yöneticisinin e-posta adresini belirtirsiniz. Edge, bu e-posta adresiyle bir kullanıcı oluşturur ve bu kullanıcıyı varsayılan sistem yöneticisi olarak ayarlar. Daha sonra, yukarıda açıklandığı şekilde başka sistem yöneticileri ekleyebilirsiniz.

Bu bölümde, varsayılan sistem yöneticisinin nasıl farklı bir kullanıcı olarak değiştirileceği ve mevcut varsayılan sistem yöneticisinin kullanıcı hesabının e-posta adresinin nasıl değiştirileceği açıklanmaktadır.

Şu anda sistem yöneticisi olarak yapılandırılmış kullanıcıların listesini görmek için aşağıdaki API çağrısını kullanın:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/userroles/sysadmin/users

Mevcut varsayılan sistem yöneticisini belirlemek için /opt/apigee/customer/defaults.sh dosyasını görüntüleyin. Dosyada, mevcut varsayılan sistem yöneticisinin e-posta adresini gösteren aşağıdaki satır bulunur:

ADMIN_EMAIL=foo@bar.com

Varsayılan sistem yöneticisini farklı bir kullanıcı olarak değiştirmek için:

  1. Yukarıda açıklandığı şekilde yeni bir sistem yöneticisi oluşturun veya yeni sistem yöneticisinin kullanıcı hesabının zaten sistem yöneticisi olarak yapılandırıldığından emin olun.
  2. /opt/apigee/customer/defaults.sh dosyasını düzenleyerek ADMIN_EMAIL değerini yeni sistem yöneticisinin e-posta adresi olarak ayarlayın.
  3. Aşağıdaki özellikleri ayarlamak için yeni Edge kullanıcı arayüzünü yüklemek üzere kullandığınız sessiz yapılandırma dosyasını düzenleyin: 
    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

    Yeni Edge kullanıcı arayüzündeki tüm özellikler sıfırlandığından SMTP özelliklerini eklemeniz gerektiğini unutmayın.

  4. Yeni Edge kullanıcı arayüzünü yeniden yapılandırma: 
    /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

Yalnızca mevcut varsayılan sistem yöneticisinin kullanıcı hesabı e-posta adresini değiştirmek istiyorsanız önce kullanıcı hesabını yeni e-posta adresini ayarlayacak şekilde güncelleyin, ardından varsayılan sistem yöneticisi e-posta adresini değiştirin:

  1. Mevcut varsayılan sistem yöneticisi kullanıcısının kullanıcı hesabını yeni bir e-posta adresiyle güncelleyin: 
    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 dosyasını ve yeni Edge kullanıcı arayüzünü güncellemek için önceki prosedürdeki 2, 3 ve 4. adımları tekrarlayın.

Sistem yöneticisinin e-posta alanını belirtme

Ek bir güvenlik düzeyi olarak, bir Edge sistem yöneticisinin gerekli e-posta alanını belirtebilirsiniz. Sistem yöneticisi eklerken kullanıcının e-posta adresi belirtilen alanda değilse kullanıcı "sysadmin" rolüne eklenemez.

Varsayılan olarak, gerekli alan boştur. Bu nedenle, "sysadmin" rolüne herhangi bir e-posta adresi ekleyebilirsiniz.

E-posta alanını ayarlamak için:

  1. management-server.properties dosyasını bir düzenleyicide açın: 
    vi /opt/apigee/customer/application/management-server.properties

    Bu dosya yoksa oluşturun.

  2. conf_security_rbac.global.roles.allowed.domains özelliğini, izin verilen alanların virgülle ayrılmış listesi olarak ayarlayın. Örneğin: 
    conf_security_rbac.global.roles.allowed.domains=myCo.com,yourCo.com
  3. Değişikliklerinizi kaydedin.
  4. Edge Management Server'ı yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

    "sysadmin" rolüne bir kullanıcı eklemeye çalışırsanız ve kullanıcının e-posta adresi belirtilen alanlardan birinde değilse ekleme işlemi başarısız olur.

Kullanıcı silme

Edge API'yi veya yeni Edge kullanıcı arayüzünü kullanarak kullanıcı oluşturabilirsiniz. Ancak kullanıcıları yalnızca API'yi kullanarak silebilirsiniz.

E-posta adresi de dahil olmak üzere mevcut kullanıcıların listesini görmek için aşağıdaki curl komutu kullanın:

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

Bir kullanıcıyı silmek için aşağıdaki curl komutunu kullanın:

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