View a markdown version of this page

Twilio API 키 - AWS Secrets Manager
보안 암호 값 필드보안 암호 메타데이터 필드사용 흐름

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Twilio API 키

보안 암호 값 필드

다음은 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"
}
accountSid

API 키를 소유한 Twilio 계정 또는 하위 계정 SID입니다.

apiKeySid

현재 API 키의 SID입니다. 표준 키와 제한 키가 모두 지원됩니다.

apiKeySecret

현재 API 키 SID와 페어링된 보안 암호입니다. Secrets Manager는이 필드를와 함께 교체합니다apiKeySid.

validationUrl

(선택 사항) Secrets Manager가 새 키가 작동하는지 확인하기 위해 호출하는 읽기 전용 Twilio API URL입니다. URL은 HTTPS와 twilio.com 호스트를 사용해야 합니다.

이 필드는 제한된 키에 필요합니다. 제한된 키는 정책에서 허용하는 엔드포인트만 호출할 수 있으므로 정책에서 허용하는 엔드포인트를 제공합니다. 표준 키의 경우 Secrets Manager는 기본 엔드포인트를 도출합니다.

보안 암호 메타데이터 필드

다음은 Twilio API 키의 메타데이터 필드입니다.

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

관리자 자격 증명을 보유한 보안 암호의 Amazon 리소스 이름(ARN)입니다. TwilioMainApiKey 유형의 보안 암호 또는 TwilioAuthToken 유형의 보안 암호를 사용합니다.

retainPreviousKey

(선택 사항) 승격 후 이전 키가 활성 상태로 유지되는지 여부입니다. 기본값: false, 이전 키를 즉시 삭제합니다. 애플리케이션이 캐시된 자격 증명을 새로 고칠 수 있도록 이전 키를 한 교체 주기 동안 사용할 수 있도록 하려면이 필드를 true로 설정합니다.

friendlyNamePrefix

(선택 사항) 각 대체 키의 표시 이름에 대한 접두사입니다. 기본값: aws-sm-api-key.

사용 흐름

이 교체는 2개의 비밀 아키텍처를 사용합니다. Twilio 키 관리 엔드포인트가 Twilio API 키 인증을 거부하기 때문에 API 키는 스스로 교체할 수 없습니다. 따라서 관리자 보안 암호는 키를 생성하고 삭제하는 자격 증명을 제공합니다.

위에서 언급한 필드와 보안 암호 유형을 TwilioApiKey로 포함하는 보안 암호 값을 사용하여 CreateSecret 호출을 사용하여 보안 암호를 생성할 수 있습니다. 교체 구성은 RotateSecret 호출을 사용하여 설정할 수 있습니다. 교체 메타데이터adminSecretArn에를 제공해야 합니다. 또한 RotateSecret 호출에서 보안 암호를 교체하는 데 필요한 권한을 서비스에 부여하는 역할 ARN을 제공해야 합니다. 권한 정책의 예는 보안 및 권한을 참조하세요.

관리자 보안 암호 유형(TwilioMainApiKey 또는 TwilioAuthToken)은 사용자 보안 암호 유형()과 다릅니다TwilioApiKey. 이러한 차이로 인해에서 범위가 지정된 기본 교체 역할 정책은 관리자 보안 암호에 대한 액세스 권한을 부여하지 secretsmanager:resource/Type 않습니다. 관리자 보안 암호에 대한 교체 역할 액세스 권한을 명시적으로 제공해야 합니다. 관리자 보안 암호 유형에 범위가 지정된 문을 추가하여이 작업을 수행할 수 있습니다. 또는 역할 정책에서 ARN 직접 관리자 암호를 지정합니다.

교체 중에 Secrets Manager는 현재 키의 유형과 정책을 읽습니다. 동일한 유형 및 정책을 포함하는 대체 키를 생성하고 대체 키를 AWSPENDING과 함께 저장합니다. 새 키가 검증 엔드포인트에 대해 인증되는지 확인합니다. 그런 다음 이전 키를 삭제하고 AWSPENDING을 AWSCURRENT로 승격합니다. 를 trueretainPreviousKey로 설정하면 Secrets Manager는 이전 키를 유지하고 다음 교체 중에 삭제합니다.

각 대체 키는 대체하는 키의 유형과 정책을 상속하므로 제한된 키는 동일한 권한으로 제한된 상태로 유지됩니다. Secrets Manager가 현재 키의 유형 또는 정책을 읽을 수 없는 경우 다른 권한을 가진 키를 생성하는 대신 교체가 실패합니다.