Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Membangun integrasi Anda

Memahami Siklus Hidup Permintaan

Sebelum membangun integrasi, penting untuk memahami bagaimana proses permintaan delegasi mulai dari pembuatan hingga penyelesaian.

Negara Permintaan

Permintaan delegasi berlangsung melalui status berikut:

Transisi Negara

Aliran Normal (Jalur Persetujuan)

Jalur Penolakan

Jalur Kedaluwarsa

Permintaan secara otomatis kedaluwarsa jika tidak ada tindakan yang diambil dalam jangka waktu yang ditentukan:

Negara Terminal

Status berikut adalah terminal (tidak ada transisi lebih lanjut):

Permintaan kedaluwarsa akhirnya dihapus dari sistem setelah periode retensi.

Mengelola status permintaan delegasi dalam aplikasi Anda

Sebagai mitra, Anda harus melacak status permintaan delegasi di sistem Anda dan menampilkannya kepada pelanggan Anda. Saat Anda menerima pemberitahuan SNS tentang perubahan status, simpan pembaruan ini di backend Anda dan sertakan di UI yang menghadap pelanggan Anda. Berikan perhatian khusus pada status Persetujuan Tertunde—ketika pelanggan meneruskan permintaan ke administrator untuk ditinjau, AWS mengirimkan pemberitahuan Persetujuan Tertunda kepada Anda. Permintaan dapat tetap dalam status ini hingga 7 hari sambil menunggu tindakan administrator. Selama waktu ini, tunjukkan kepada pelanggan bahwa permintaan mereka sedang menunggu persetujuan administrator dalam aplikasi Anda. Pertimbangkan untuk menyediakan tautan mendalam ke Kon AWS sol tempat pelanggan dapat memeriksa status permintaan atau menindaklanjuti dengan administrator mereka. Menangani mesin status dengan benar di backend Anda dan menampilkan informasi status yang benar kepada pelanggan di setiap tahap penting untuk pengalaman integrasi yang baik.

Mengkonfigurasi Pemberitahuan

IAM menggunakan Amazon Simple Notification Service (SNS) untuk mengkomunikasikan perubahan status permintaan delegasi kepada Anda. Saat membuat permintaan delegasi, Anda harus memberikan topik SNS ARN dari AWS akun terdaftar Anda. IAM akan menerbitkan pesan ke topik ini untuk acara penting, termasuk ketika pelanggan menyetujui atau menolak permintaan dan ketika token pertukaran siap.

Konfigurasi Topik SNS

Untuk menerima pemberitahuan permintaan delegasi, Anda harus mengonfigurasi topik SNS untuk memberikan izin IAM untuk menerbitkan pesan ke topik tersebut. Tambahkan pernyataan kebijakan berikut ke kebijakan topik SNS Anda:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowIAMServiceToPublish",
            "Effect": "Allow",
            "Principal": {
                "Service": "iam.amazonaws.com"
            },
            "Action": "SNS:Publish",
            "Resource": "arn:aws:sns:REGION:ACCOUNT-ID:TOPIC-NAME"
        }
    ]
}

Jenis Pemberitahuan

IAM mengirimkan dua jenis notifikasi:

StateChange Pemberitahuan

Dikirim saat permintaan delegasi beralih ke status baru (Ditugaskan, Menunggu Persetujuan, Diterima, Selesai, Ditolak, Kedaluwarsa).

ExchangeToken Pemberitahuan

Dikirim saat pelanggan melepaskan token delegasi (status Finalized). Pemberitahuan ini menyertakan token pertukaran yang Anda butuhkan untuk mendapatkan kredenSIAL.

Negara Pemberitahuan

Anda akan menerima pemberitahuan untuk status permintaan delegasi berikut:

Format Pesan Pemberitahuan

IAM menerbitkan pemberitahuan SNS standar. Informasi permintaan delegasi terkandung dalam bidang Pesan sebagai string JSON.

Bidang Umum (Semua Pemberitahuan)

Bidang Tambahan (ExchangeToken Hanya Pemberitahuan)

Contoh Pemberitahuan

StateChange Pemberitahuan

{
  "Type": "Notification",
  "MessageId": "61ee8ad4-6eec-56b5-8f3d-eba57556aa13",
  "TopicArn": "arn:aws:sns:us-east-1:123456789012:partner-notifications",
  "Message": "{\"RequestorWorkflowId\":\"workflow-12345\",\"Type\":\"StateChange\",\"RequestId\":\"dr-abc123\",\"State\":\"ACCEPTED\",\"OwnerAccountId\":\"111122223333\",\"UpdatedAt\":\"2025-01-15T10:30:00.123Z\"}",
  "Timestamp": "2025-01-15T10:30:00.456Z",
  "SignatureVersion": "1",
  "Signature": "...",
  "SigningCertURL": "...",
  "UnsubscribeURL": "..."
}

ExchangeToken Pemberitahuan

{
  "Type": "Notification",
  "MessageId": "e44e5435-c72c-5333-aba3-354406782f5b",
  "TopicArn": "arn:aws:sns:us-east-1:123456789012:partner-notifications",
  "Message": "{\"RequestId\":\"dr-abc123\",\"RequestorWorkflowId\":\"workflow-12345\",\"State\":\"FINALIZED\",\"OwnerAccountId\":\"111122223333\",\"ExchangeToken\":\"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\"ExpiresAt\":\"2025-01-15T18:30:00.123Z\",\"UpdatedAt\":\"2025-01-15T10:30:00.456Z\",\"Type\":\"ExchangeToken\"}",
  "Timestamp": "2025-01-15T10:30:00.789Z",
  "SignatureVersion": "1",
  "Signature": "...",
  "SigningCertURL": "...",
  "UnsubscribeURL": "..."
}

Tukarkan Token

Token pertukaran atau token perdagangan dikeluarkan oleh IAM ketika pelanggan menerima dan menyelesaikan permintaan delegasi. Penyedia produk menggunakan pertukaran atau token perdagangan ini untuk memanggil AWS STS GetDelegatedAccessToken API untuk mendapatkan AWS kredenSIAL sementara dengan izin yang disetujui pelanggan. Token pertukaran itu sendiri tidak memberikan akses ke AWS sumber daya Anda; itu harus ditukar dengan kredenSIAL aktual melalui AWS STS.

Token pertukaran hanya dapat ditukarkan oleh akun penyedia produk yang membuat permintaan delegasi. Akun yang diminta disematkan dalam token, memastikan bahwa hanya penyedia produk resmi yang dapat memperoleh kredenSIAL untuk mengakses akun pelanggan.

Durasi Akses

Periode delegasi dimulai saat pelanggan melepaskan token pertukaran, bukan saat penyedia produk menebusnya. Setelah pelanggan melepaskan token:

Penukaran Ganda

Penyedia produk dapat menukar token beberapa kali selama masa berlaku untuk mendapatkan kredenSIAL baru. Namun, semua kredenSIAL yang diperoleh dari token pertukaran yang sama kedaluwarsa pada saat yang sama, berdasarkan kapan Anda merilis token.

Contoh: Jika Anda menyetujui permintaan delegasi selama 2 jam dan melepaskan token pada pukul 10:00 pagi:

Seperti yang ditunjukkan pada tabel, menukar token nanti dalam periode validitas menghasilkan waktu yang kurang dapat digunakan untuk penyedia produk.