Edge for Private Cloud 4.17.01 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 <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>'
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
configFile, kullanıcıyı oluşturmak için gerekli bilgileri içerir:
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
Ardından, kullanıcıyla ilgili bilgileri görüntülemek için bu çağrıyı kullanabilirsiniz:
curl -u <sysAdminEmail>:<passwd> 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 <sysAdminEmail>:<passwd>
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 <sysAdminEmail>:<passwd>
Aşağıdaki komutu kullanarak kullanıcının rollerini görüntüleyebilirsiniz:
curl -u <sysAdminEmail>:<passwd> / 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 <sysAdminEmail>:<passwd> 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:
- Edge kullanıcı arayüzünde veya API'de kullanıcı oluşturun.
- Kullanıcıyı sysadmin rolüne ekleyin:
curl -u <sysAdminEmail>:<passwd> \
-X POST http://<ms_IP>:8080/v1/userroles/sysadmin/users \
-d 'id=foo@bar.com' - Yeni kullanıcının sysadmin rolünde olduğundan emin olun:
curl -u <sysAdminEmail>:<passwd> http://<ms_IP>:8080/v1/userroles/sysadmin/users
Kullanıcının e-posta adresini döndürür:
[ " foo@bar.com " ] - Yeni kullanıcının izinlerini kontrol edin:
curl -u <sysAdminEmail>:<passwd> http://<ms_IP>:8080/v1/users/foo@bar.com/permissions
Döndürülen değer:
{
"resourcePermission" : [ {
"path" : "/",
"permissions" : [ "get", "put", "delete" ]
} ]
} - Yeni sistem yöneticisini ekledikten sonra kullanıcıyı istediğiniz kuruluşa ekleyebilirsiniz.
Not: Yeni sistem yöneticisi kullanıcı, kullanıcıyı en az bir kuruluşa ekleyene kadar Edge kullanıcı arayüzüne giriş yapamaz. - Kullanıcıyı daha sonra sistem yöneticisi rolünden kaldırmak isterseniz aşağıdaki API'yi kullanabilirsiniz:
curl -X DELETE -u <sysadminEmail:pword>
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 sysAdminEmail:passwd 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. Dosya, mevcut varsayılan sistem yöneticisinin e-posta adresini gösteren aşağıdaki satırı içerir:
ADMIN_EMAIL=foo@bar.com
Varsayılan sistem yöneticisini farklı bir kullanıcı olarak değiştirmek için:
- 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.
- ADMIN_EMAIL değerini yeni sistem yöneticisinin e-posta adresi olarak ayarlamak için /opt/apigee/customer/defaults.sh dosyasını düzenleyin.
- Edge kullanıcı arayüzünü yüklemek için kullandığınız sessiz yapılandırma dosyasını düzenleyerek aşağıdaki özellikleri ayarlayın:
ADMIN_EMAIL=emailAddressOfNewSysAdmin
APIGEE_ADMINPW=pwOfNewSysAdmin
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ığı için SMTP özelliklerini eklemeniz gerektiğini unutmayın. - 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:
- 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 currentSysAdminEmail:passwd /
http://<ms_IP>:8080/v1/users/currentSysAdminEmail /
-d '{"emailId": "newSysAdminEmail", "lastName": "admin", "firstName": "admin"}' - /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ıyı sysadmin rolüne ekleme işlemi başarısız olur.
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:
- Bir düzenleyicide management-server.properties dosyasını açın:
vi /opt/apigee/customer/application/management-server.properties
Bu dosya yoksa oluşturun. - conf_security_rbac.global.roles.allowed.domains özelliğini, izin verilen alanların virgülle ayrılmış listesine ayarlayın. Örneğin:
conf_security_rbac.global.roles.allowed.domains=myCo.com,yourCo.com - Değişikliklerinizi kaydedin.
- Edge Management Server'ı yeniden başlatın:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
Şimdi 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 <sysAdminEmail>:<passwd> http://<ms-IP>:8080/v1/users
Bir kullanıcıyı silmek için aşağıdaki cURL komutunu kullanın:
curl -u <sysAdminEmail>:<passwd> -X DELETE http://<ms-IP>:8080/v1/users/<userEmail>