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

Edge for Private Cloud 4.18.05 sürümü

Apigee dokümanlar sitesinde, kullanıcı rollerini ve izinlerini yönetme hakkında kapsamlı bilgiler bulunur. Kullanıcılar hem 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 için şu kaynaklara bakın:

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 çalışı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

Edge API, Edge kullanıcı arayüzü veya Edge komutlarını kullanarak kullanıcı oluşturabilirsiniz. Bu bölümde, Edge API ve Edge komutlarının nasıl kullanılacağı açıklanmaktadır. 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, kullanıcıyla ilgili bilgileri görüntülemek için bu çağrıyı kullanabilirsiniz:

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 önce bir kuruluştaki role atanması gerekir. Kullanıcıyı orgadmin, businessuser, opsadmin, user gibi farklı rollere veya kuruluşta tanımlanmış özel bir role atayabilirsiniz.

Bir kullanıcıyı bir kuruluştaki role atamak, o kullanıcıyı otomatik olarak kuruluşa ekler. Bir kullanıcıyı birden fazla kuruluşa atamak için her kuruluşta bir role 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 o 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ı 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. Kullanıcıları "sysadmin" rolüne atama işlemi Edge kullanıcı arayüzünde yapılamaz.

Sistem yöneticisi eklemek için:

  1. 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 çağrının kullanıcıyı yalnızca rolden kaldırdığını, silmediğini unutmayın.

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

Edge'i yüklerken 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 farklı bir kullanıcı olarak nasıl değiştirileceği ve mevcut varsayılan sistem yöneticisinin kullanıcı hesabına ait 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 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 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

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

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

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 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, "sysadmin" rolüne herhangi bir e-posta adresi ekleyebileceğiniz anlamına gelir.

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 Yönetim Sunucusu'nu 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 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 komutunu 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