Resource Access Management (RAM) kullanarak API grupları, API'ler, eklentiler ve uygulamalar gibi API Gateway kaynakları üzerinde farklı çalışanlara belirli izinler atayabilirsiniz.
API'ler için izin yönetimine ihtiyacınız yoksa bu konuyu atlayın.
RAM kullanıcıları API Gateway'de API gruplarını, API'leri veya eklentileri görüntüleyebilir, oluşturabilir ya da silebilir. Bu kaynakların sahibi değillerdir; Alibaba Cloud hesabı izinlerini istediği zaman iptal edebilir.
Etiket tabanlı yetkilendirme ile Alibaba Cloud hesabı ve RAM kullanıcıları arasındaki kaynaklar izole edilebilir.
API izinlerini RAM ile yönetmeden önce RAM ve API Gateway hakkında bilgi edinmeniz önerilir. Alibaba Cloud Yardım Merkezi'nde bu hizmetlere ilişkin belgeler bulunmaktadır.
İlkelere genel bakış
Bir ilke, Effect (Etki), Resource (Kaynak), Action (Eylem) ve Condition (Koşul) olmak üzere dört öğe kullanılarak izinleri tanımlar.
1. Sistem ilkesi
API Gateway iki yerleşik sistem ilkesi sağlar. Bunları RAM konsol üzerindeki Policies sayfasında görüntüleyebilirsiniz. 
AliyunApiGatewayFullAccess: API grupları, API'ler, kısıtlama ilkeleri ve uygulamalar dahil olmak üzere tüm API Gateway kaynakları üzerinde tam yönetim izni verir.
AliyunApiGatewayReadOnlyAccess: API grupları, API'ler, kısıtlama ilkeleri ve uygulamalar dahil olmak üzere tüm API Gateway kaynaklarına salt okunur erişim sağlar. Ancak RAM kullanıcısı kaynakları yönetemez.
2. Özel ilke
Belirli eylemler veya kaynaklar üzerinde daha ayrıntılı izinler vermek için özel bir ilke oluşturun. Örneğin, GetUsers işlemi için düzenleme izni veren özel bir ilke oluşturabilirsiniz. Özel ilkelerinizi görüntülemek için RAM konsol adresine giriş yapın, Permissions > Policies seçeneğini belirleyin ve Custom Policy seçeneğini Policy Type açılır listesinden seçin.
İlke sözdizimi
Bir ilke, izinleri tanımlamak için belirli bir sözdizimi kullanır. Belirli kaynaklar üzerinde izin vermek için bir ilkeyi bir kullanıcıya veya gruba ekleyin.
Örnek:
{
"Version": "1",
"Statement": [
{
"Action": "apigateway:Describe*",
"Resource": "*",
"Effect": "Allow"
}
]
}
Bu ilke, bir RAM kullanıcısının tüm API Gateway kaynaklarını sorgulamasına olanak tanır.
The Action element describes one or more API operations. The parameters in the Action element must be specified in the following format:
"Action":"<service-name>:<action-name>"
Parametreler:
service-name: Alibaba Cloud hizmet adı. API Gateway için apigateway olarak ayarlayın.
-
action-name: Bir API işleminin adı. Joker karakter (*) desteklenir. "Resource syntax" bölümünde mevcut tüm işlemler listelenmiştir.
"Action" değerini "apigateway:Describe*" olarak ayarlarsanız yetkilendirilen RAM kullanıcısı API Gateway'deki tüm kaynakları sorgulama iznine sahip olur.
"Action" değerini "apigateway:*" olarak ayarlarsanız yetkilendirilen RAM kullanıcısı API Gateway'deki tüm kaynakları yönetme iznine sahip olur.
Kaynak sözdizimi
Resource öğesi, bir ifadenin kapsadığı nesneleri belirtir. API Gateway'de API gruplarını, kısıtlama ilkelerini ve uygulamaları belirtebilirsiniz. Aşağıdaki biçimi kullanın:
acs:<service-name>:<region>:<account-id>:<relative-id>
Parametreler:
acs: Alibaba Cloud public cloud ad alanı.
service-name: Alibaba Cloud hizmet adı. API Gateway için apigateway olarak ayarlayın.
region: İlkenin uygulandığı bölge. Tüm bölgeler için joker karakter (*) kullanın.
account-id: Hesap ID'si, örneğin 123456789012****. Joker karakter (*) desteklenir.
relative-id: Dosya yolu benzeri bir biçimde belirtilen kaynak tanımlayıcısı.
Bir RDPath aşağıdaki biçimlerden birindedir:
acs:apigateway:$regionid:$accountid:apigroup/$groupId
Örnek:
acs:apigateway:*:*:apigroup/cbd157704e624ab58a204fd3e0b5ad79
Aşağıdaki tabloda API Gateway ilkelerindeki action-name parametresi için kullanılabilen API işlemleri listelenmektedir. Daha fazla bilgi için bkz. "API Gateway API Reference".
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Örnekler
Bir RAM kullanıcısına tüm API'leri sorgulama yetkisi verin:
{
"Version": "1",
"Statement": [
{
"Action": "apigateway:Describe*",
"Resource":"acs:apigateway:$regionid:$accountid:apigroup/*",
"Effect": "Allow"
}
]
}
Bir RAM kullanıcısına version:v1 etiketi eklenmiş tüm API gruplarını sorgulama yetkisi verin:
{
"Version": "1",
"Statement": [
{
"Action": "apigateway:Describe*",
"Resource":"acs:apigateway:$regionid:$accountid:apigroup/*",
"Effect": "Allow",
"Condition": {
"StringEquals": {
"apigateway:tag/version": "v1"
}
}
}
]
}
Bir RAM kullanıcısına bir API grubundaki tüm API'leri yönetme yetkisi verin:
{
"Version": "1",
"Statement": [
{
"Action": "apigateway:*",
"Resource": [
"acs:apigateway:$regionid:$accountid:apigroup/$groupId",
"acs:apigateway:$regionid:$accountid:app/$appId",
"acs:apigateway:$regionid:$accountid:vpcaccess/*"
],
"Effect": "Allow"
}
]
}
Note: In the preceding examples, you can specify the wildcard character (*) for variables based on your business requirements.