View a markdown version of this page

Twilio Kunci API - AWS Secrets Manager
Bidang Nilai RahasiaBidang Metadata RahasiaAliran Penggunaan

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

Twilio Kunci API

Bidang Nilai Rahasia

Berikut ini adalah bidang-bidang yang harus dimuat dalam rahasia Secrets Manager:

{
  "accountSid": "AC followed by 32 hexadecimal characters",
  "apiKeySid": "SK followed by 32 hexadecimal characters",
  "apiKeySecret": "API key secret",
  "validationUrl": "https://api.twilio.com/2010-04-01/Accounts/ACxxxx/Messages.json?PageSize=1"
}
AkunSID

TwilioAkun atau subaccount SID yang memiliki kunci API.

api KeySid

SID dari kunci API saat ini. Kunci Standar dan Terbatas didukung.

api KeySecret

Rahasia dipasangkan dengan SID kunci API saat ini. Secrets Manager memutar bidang ini bersama-sama denganapiKeySid.

ValidationURL

(Opsional) URL Twilio API hanya-baca yang dipanggil Secrets Manager untuk mengonfirmasi kunci baru berfungsi. URL harus menggunakan HTTPS dan twilio.com host.

Bidang ini diperlukan untuk kunci Terbatas. Kunci Terbatas hanya dapat memanggil titik akhir yang diizinkan oleh kebijakannya, jadi berikan titik akhir yang Anda tahu diizinkan oleh kebijakan tersebut. Untuk kunci Standar, Secrets Manager mendapatkan titik akhir default.

Bidang Metadata Rahasia

Berikut ini adalah bidang metadata untuk Twilio API Key:

{
  "adminSecretArn": "arn:aws:secretsmanager:us-east-1:111122223333:secret:TwilioMainApiKey",
  "retainPreviousKey": "false",
  "friendlyNamePrefix": "aws-sm-api-key"
}
admin SecretArn

Nama Sumber Daya Amazon (ARN) dari rahasia yang memegang kredensi administrator. Gunakan rahasia tipe TwilioMainApiKey atau rahasia tipe TwilioAuthToken.

mempertahankan PreviousKey

(Opsional) Apakah kunci sebelumnya tetap aktif setelah promosi. Default: false, yang segera menghapus kunci sebelumnya. Setel bidang ini ke true agar kunci sebelumnya dapat digunakan untuk satu siklus rotasi, sehingga aplikasi dapat menyegarkan kredensyal yang di-cache.

ramah NamePrefix

(Opsional) Awalan untuk nama ramah dari setiap tombol pengganti. Default: aws-sm-api-key.

Aliran Penggunaan

Rotasi ini menggunakan arsitektur dua rahasia. Kunci Twilio API tidak dapat berputar sendiri, karena titik akhir manajemen Twilio kunci menolak otentikasi kunci API. Oleh karena itu, rahasia administrator menyediakan kredensi yang membuat dan menghapus kunci.

Anda dapat membuat rahasia Anda menggunakan CreateSecretpanggilan dengan nilai rahasia yang berisi bidang yang disebutkan di atas dan tipe rahasia sebagai TwilioApiKey. Konfigurasi rotasi dapat diatur menggunakan RotateSecretpanggilan. Anda harus memberikan metadata rotasi. adminSecretArn Anda juga harus memberikan peran ARN dalam RotateSecretpanggilan yang memberikan layanan izin yang diperlukan untuk memutar rahasia. Untuk contoh kebijakan izin, lihat Keamanan dan Izin.

Jenis rahasia administrator (TwilioMainApiKeyatauTwilioAuthToken) berbeda dari tipe rahasia pengguna (TwilioApiKey). Karena perbedaan ini, kebijakan peran rotasi default yang dicakup oleh secretsmanager:resource/Type tidak memberikan akses ke rahasia administrator. Anda harus secara eksplisit memberikan akses peran rotasi ke rahasia administrator. Anda dapat melakukan ini dengan menambahkan pernyataan yang dicakup ke tipe rahasia administrator. Atau, tentukan rahasia administrator ARN secara langsung dalam kebijakan peran.

Selama rotasi, Secrets Manager membaca jenis dan kebijakan kunci saat ini. Ini menciptakan kunci pengganti yang membawa jenis dan kebijakan yang sama, dan menyimpan penggantian sebagai AWSPENDING. Ini menegaskan bahwa kunci baru mengautentikasi terhadap titik akhir validasi. Kemudian menghapus kunci sebelumnya dan mempromosikan AWSPENDING ke AWSCRENT. Jika Anda menyetel retainPreviousKey ke true, Secrets Manager menyimpan kunci sebelumnya dan menghapusnya selama rotasi berikutnya.

Setiap kunci pengganti mewarisi tipe dan kebijakan kunci yang digantikannya, sehingga kunci Terbatas tetap Dibatasi dengan izin yang sama. Rotasi gagal alih-alih membuat kunci dengan hak istimewa yang berbeda ketika Secrets Manager tidak dapat membaca jenis atau kebijakan kunci saat ini.