Pemberitahuan akhir dukungan: Pada 31 Maret 2027, AWS akan mengakhiri dukungan untuk Amazon WorkMail. Setelah 31 Maret 2027, Anda tidak akan lagi dapat mengakses WorkMail konsol Amazon atau WorkMail sumber daya Amazon. Untuk informasi selengkapnya, lihat [dukungan WorkMail akhir Amazon](https://docs.aws.amazon.com/workmail/latest/adminguide/workmail-end-of-support.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bagaimana Amazon WorkMail bekerja dengan IAM
Sebelum Anda menggunakan IAM untuk mengelola akses ke Amazon WorkMail, Anda harus memahami fitur IAM apa yang tersedia untuk digunakan dengan Amazon. WorkMail Untuk mendapatkan tampilan tingkat tinggi tentang cara Amazon WorkMail dan AWS layanan lainnya bekerja dengan IAM, lihat [AWS layanan yang bekerja dengan IAM di Panduan Pengguna *IAM*](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html).
**Topics**
+ [Kebijakan WorkMail berbasis identitas Amazon](#security_iam_service-with-iam-id-based-policies)
+ [Kebijakan berbasis WorkMail sumber daya Amazon](#security_iam_service-with-iam-resource-based-policies)
+ [Otorisasi berdasarkan tag Amazon WorkMail](#security_iam_service-with-iam-tags)
+ [Peran Amazon WorkMail IAM](#security_iam_service-with-iam-roles)
## Kebijakan WorkMail berbasis identitas Amazon
Dengan kebijakan berbasis identitas IAM, Anda dapat menentukan secara spesifik apakah tindakan dan sumber daya diizinkan atau ditolak, serta kondisi yang menjadi dasar dikabulkan atau ditolaknya tindakan tersebut. Amazon WorkMail mendukung tindakan, sumber daya, dan kunci kondisi tertentu. Untuk mempelajari semua elemen yang Anda gunakan dalam kebijakan JSON, lihat [Referensi Elemen Kebijakan JSON IAM ](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) dalam *Panduan Pengguna IAM*.
### Tindakan
Administrator dapat menggunakan kebijakan AWS JSON untuk menentukan siapa yang memiliki akses ke apa. Yaitu, di mana **utama** dapat melakukan **tindakan** pada **sumber daya**, dan dalam **kondisi apa**.
Elemen `Action` dari kebijakan JSON menjelaskan tindakan yang dapat Anda gunakan untuk mengizinkan atau menolak akses dalam sebuah kebijakan. Sertakan tindakan dalam kebijakan untuk memberikan izin untuk melakukan operasi terkait.
Tindakan kebijakan di Amazon WorkMail menggunakan awalan berikut sebelum tindakan:`workmail:`. Misalnya, untuk memberikan izin kepada seseorang untuk mengambil daftar pengguna dengan operasi Amazon WorkMail `ListUsers` API, Anda menyertakan `workmail:ListUsers` tindakan tersebut dalam kebijakan mereka. Pernyataan kebijakan harus memuat elemen `Action` atau `NotAction`. Amazon WorkMail mendefinisikan serangkaian tindakannya sendiri yang menggambarkan tugas yang dapat Anda lakukan dengan layanan ini.
Untuk menetapkan beberapa tindakan dalam satu pernyataan, pisahkan dengan koma seperti berikut:
```
"Action": [
"workmail:ListUsers",
"workmail:DeleteUser"
```
Anda dapat menentukan beberapa tindakan menggunakan wildcard (\*). Sebagai contoh, untuk menentukan semua tindakan yang dimulai dengan kata `List`, sertakan tindakan berikut:
```
"Action": "workmail:List*"
```
Untuk melihat daftar tindakan Amazon, lihat WorkMail [Tindakan yang ditentukan oleh Amazon WorkMail](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonworkmail.html#amazonworkmail-actions-as-permissions) di *Panduan Pengguna IAM*.
### Sumber daya
Administrator dapat menggunakan kebijakan AWS JSON untuk menentukan siapa yang memiliki akses ke apa. Yaitu, di mana **utama** dapat melakukan **tindakan** pada **sumber daya**, dan dalam **kondisi apa**.
Elemen kebijakan JSON `Resource` menentukan objek yang menjadi target penerapan tindakan. Praktik terbaiknya, tentukan sumber daya menggunakan [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). Untuk tindakan yang tidak mendukung izin di tingkat sumber daya, gunakan wildcard (\*) untuk menunjukkan bahwa pernyataan tersebut berlaku untuk semua sumber daya.
```
"Resource": "*"
```
Amazon WorkMail mendukung izin tingkat sumber daya untuk organisasi Amazon. WorkMail
Sumber daya WorkMail organisasi Amazon memiliki ARN berikut:
```
arn:aws:workmail:${Region}:${Account}:organization/${OrganizationId}
```
Untuk informasi selengkapnya tentang format ARN, lihat [Amazon Resource Names (ARN) dan ruang nama AWS layanan](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
Misalnya, untuk menentukan organisasi `m-n1pq2345678r901st2u3vx45x6789yza` dalam pernyataan Anda, gunakan ARN berikut.
```
"Resource": "arn:aws:workmail:us-east-1:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza"
```
Untuk menentukan semua organisasi milik akun tertentu, gunakan wildcard (\*):
```
"Resource": "arn:aws:workmail:us-east-1:111122223333:organization/*"
```
Beberapa WorkMail tindakan Amazon, seperti untuk membuat sumber daya, tidak dapat dilakukan pada sumber daya tertentu. Dalam kasus tersebut, Anda harus menggunakan wildcard (\*).
```
"Resource": "*"
```
Untuk melihat daftar jenis WorkMail sumber daya Amazon dan ARNnya, lihat [Sumber daya yang ditentukan oleh Amazon WorkMail](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonworkmail.html#amazonworkmail-resources-for-iam-policies) di *Panduan Pengguna IAM*. Untuk mempelajari tindakan yang dapat Anda tentukan untuk ARN setiap sumber daya, lihat [Tindakan, sumber daya, dan kunci kondisi untuk Amazon](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonworkmail.html). WorkMail
### Kunci syarat
Amazon WorkMail mendukung kunci kondisi global berikut.
+ `aws:CurrentTime`
+ `aws:EpochTime`
+ `aws:MultiFactorAuthAge`
+ `aws:MultiFactorAuthPresent`
+ `aws:PrincipalOrgID`
+ `aws:PrincipalArn`
+ `aws:RequestedRegion`
+ `aws:SecureTransport`
+ `aws:UserAgent`
Contoh kebijakan berikut memberikan akses ke WorkMail konsol Amazon hanya dari prinsipal IAM yang diautentikasi MFA di Wilayah AWS. `eu-west-1`
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ses:Describe*",
"ses:Get*",
"workmail:Describe*",
"workmail:Get*",
"workmail:List*",
"workmail:Search*",
"lambda:ListFunctions",
"iam:ListRoles",
"logs:DescribeLogGroups",
"cloudwatch:GetMetricData"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:RequestedRegion": [
"eu-west-1"
]
},
"Bool": {
"aws:MultiFactorAuthPresent": true
}
}
}
]
}
```
------
Untuk melihat semua kunci kondisi AWS global, lihat [kunci konteks kondisi AWS global](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) di *Panduan Pengguna IAM*.
`workmail:ImpersonationRoleId`adalah satu-satunya kunci kondisi khusus layanan yang didukung oleh Amazon. WorkMail
Contoh kebijakan berikut mencakup `AssumeImpersonationRole` tindakan ke bawah untuk WorkMail organisasi tertentu dan peran peniruan identitas.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"workmail:AssumeImpersonationRole"
],
"Resource": "arn:aws:workmail:{{us-east-1}}:{{111122223333}}:organization/{{m-n1pq2345678r901st2u3vx45x6789yza}}",
"Condition": {
"StringEquals": {
"workmail:ImpersonationRoleId":"{{12345678-1234-1234-1234-123456789012}}"
}
}
}
]
}
```
------
### Contoh
Untuk melihat contoh kebijakan WorkMail berbasis identitas Amazon, lihat. [Contoh WorkMail kebijakan berbasis identitas Amazon](security_iam_id-based-policy-examples.md)
## Kebijakan berbasis WorkMail sumber daya Amazon
Amazon WorkMail tidak mendukung kebijakan berbasis sumber daya.
## Otorisasi berdasarkan tag Amazon WorkMail
Anda dapat melampirkan tag ke WorkMail sumber daya Amazon atau meneruskan tag dalam permintaan ke Amazon WorkMail. Untuk mengendalikan akses berdasarkan tanda, berikan informasi tentang tanda di [elemen kondisi](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) dari kebijakan menggunakan kunci kondisi `aws:ResourceTag/key-name`, `aws:RequestTag/key-name`, atau `aws:TagKeys`. Untuk informasi selengkapnya tentang menandai WorkMail sumber daya Amazon, lihat[Penandaan sebuah organisasi](org-tag.md).
## Peran Amazon WorkMail IAM
[Peran IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) adalah entitas dalam AWS akun Anda yang memiliki izin tertentu.
### Menggunakan kredensyal sementara dengan Amazon WorkMail
Anda dapat menggunakan kredensial sementara untuk masuk dengan gabungan, menjalankan IAM role, atau menjalankan peran lintas akun. Anda memperoleh kredensil keamanan sementara dengan memanggil operasi AWS STS API seperti [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)atau. [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html)
Amazon WorkMail mendukung penggunaan kredensyal sementara.
### Service-linked peran
[Service-linked peran](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) memungkinkan AWS layanan mengakses sumber daya di layanan lain untuk menyelesaikan tindakan atas nama Anda. Service-linked peran muncul di akun IAM Anda dan dimiliki oleh layanan. Administrator IAM dapat melihat tetapi tidak dapat mengedit izin untuk peran terkait layanan.
Amazon WorkMail mendukung peran terkait layanan. Untuk detail tentang membuat atau mengelola peran WorkMail terkait layanan Amazon, lihat. [Menggunakan peran terkait layanan untuk Amazon WorkMail](using-service-linked-roles.md)
### Peran layanan
Fitur ini memungkinkan layanan untuk menerima [peran layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role) atas nama Anda. Peran ini mengizinkan layanan untuk mengakses sumber daya di layanan lain untuk menyelesaikan tindakan atas nama Anda. Peran layanan muncul di akun IAM Anda dan dimiliki oleh akun tersebut. Ini berarti administrator IAM dapat mengubah izin untuk peran ini. Namun, melakukan hal itu dapat merusak fungsionalitas layanan.
Amazon WorkMail mendukung peran layanan.