View a markdown version of this page

SonarQube 토큰 - AWS Secrets Manager
보안 암호 값 필드보안 암호 메타데이터 필드사용 흐름

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

SonarQube 토큰

보안 암호 값 필드

다음은 Secrets Manager 보안 암호에 포함되어야 하는 필드입니다.

{
  "token": "token value",
  "tokenName": "token name",
  "login": "user that owns the token",
  "sonarqubeUrl": "https://sonarqube.example.com",
  "tokenType": "USER_TOKEN",
  "projectKey": "project key"
}
token

SonarQube 토큰 값(squ_, sqa_또는 로 시작sqp_). 교체 프로세스는이 필드를 업데이트합니다.

tokenName

토큰 이름(사용자당 고유). 교체는이 이름을 사용하여 이전 토큰을 취소합니다.

login

토큰을 소유한 SonarQube 사용자입니다.

sonarqubeUrl

SonarQube 인스턴스 URL(예: https://sonarqube.example.com). URL은 HTTPS를 사용해야 하며 후행 슬래시로 끝나지 않아야 합니다.

tokenType

(선택 사항) 토큰 유형: USER_TOKEN (기본값), GLOBAL_ANALYSIS_TOKEN또는 PROJECT_ANALYSIS_TOKEN.

projectKey

(선택 사항) SonarQube 프로젝트 키입니다. tokenType가 인 경우에만 필요합니다PROJECT_ANALYSIS_TOKEN.

보안 암호 메타데이터 필드

다음은 SonarQube 토큰의 메타데이터 필드입니다.

{
  "adminSecretArn": "arn:aws:secretsmanager:us-east-1:111122223333:secret:SonarQubeAdmin"
}
adminSecretArn

(선택 사항) 관리자 토큰이 포함된 SonarQubeToken 유형의 보안 암호에 대한 Amazon 리소스 이름(ARN)입니다. 이 필드는 글로벌 분석 및 프로젝트 분석 토큰에 필요합니다. 사용자 토큰의 경우 선택 사항입니다. 현재 토큰이 자체 교체를 생성하고 취소하는 자체 회전을 활성화하려면이 토큰을 생략합니다.

사용 흐름

이 교체는 사용자 토큰의 경우 단일 보안 암호(자체 교체)를 지원하고 글로벌 분석 및 프로젝트 분석 토큰의 경우 2개의 보안 암호(관리자 지원) 교체를 지원합니다. tokenType 값은 토큰 범위를 결정합니다.

보안 암호를 생성하려면 CreateSecret API 호출을 사용합니다. 보안 암호 값을 위에 설명된 필드로 설정하고 보안 암호 유형을 SonarQubeToken으로 설정합니다. 교체를 구성하려면 RotateSecret API 호출을 사용합니다. RotateSecret 호출에서 보안 암호를 교체할 수 있는 권한을 서비스에 부여하는 역할 ARN을 제공합니다. 권한 정책의 예는 보안 및 권한을 참조하세요. 관리자 지원 교체를 사용하는 경우 교체 역할에 관리자 보안 암호 ARN에 대한 액세스 권한을 명시적으로 부여합니다.

교체 중에 드라이버는 새 토큰을 생성하고, 이를 보류 중인 버전으로 저장하고, SonarQube API에 대해 검증하고, 이를 최신으로 승격한 다음,에 의해 이전 토큰을 취소합니다tokenName. Secrets Manager 캐싱 라이브러리를 사용하는 애플리케이션은 다음 새로 고침 시 새 토큰을 선택합니다.

SonarQube 서버는 고객 호스팅되므로 Secrets Manager 교체 서비스에서 HTTPS를 통해 SonarQube 인스턴스에 연결할 수 있어야 합니다. 교체 호출은 AWS관리형 접두사 목록에서 시작됩니다com.amazonaws.region.secretsmanager-managed-external-secrets. 인스턴스의 보안 그룹 또는 방화벽에서이 접두사 목록의 인바운드 액세스를 허용하고 인스턴스가 공개적으로 신뢰할 수 있는 TLS 인증서를 제공하는지 확인합니다. 자세한 내용은 Amazon VPC 사용 설명서의 AWS관리형 접두사 목록을 참조하세요. 퍼블릭 인터넷을 통해 연결할 수 없는 인스턴스는 지원되지 않습니다.