Secrets Manager 사용하기

Documentation Index

Fetch the complete documentation index at: https://docs.crewai.com/llms.txt

Use this file to discover all available pages before exploring further.

​

개요

이 가이드는 공급자 중립적입니다. 사용자(또는 다른 관리자)가 이미 최소 하나의 Secret Provider Credential을 구성했다고 가정합니다. 원하는 경로에 따라 설정 가이드를 선택하세요:

• 정적 자격 증명: AWS · GCP
• Workload Identity (로테이션 인식): AWS · GCP

이 가이드를 사용하여 다음을 수행하세요:

• 조직 멤버에게 적절한 권한을 부여합니다.
• 자동화의 환경 변수에서 시크릿을 참조합니다.
• 런타임에서 모든 것이 올바르게 해석되는지 확인합니다.

​

권한 (RBAC)

Secrets Manager를 사용할 때 관련된 세 가지 CrewAI Platform 기능:

• secret_providers — Secret Provider Credentials 페이지에 대한 접근을 제어합니다.
• workload_identity_configs — Workload Identity 페이지에 대한 접근을 제어합니다(WI 경로를 사용하는 경우에만 관련됨).
• environment_variables — 환경 변수를 생성하거나 편집할 수 있는 사람을 제어합니다.

각 기능에는 두 가지 작업 수준이 있습니다: read와 manage. manage를 부여하면 자동으로 read를 포함합니다.

​

부여할 권한

​

할당 방법

1. CrewAI Platform에서 Settings → Roles로 이동합니다. 이 페이지에서 새 역할을 생성하고, 각 역할의 권한을 편집하며, 조직의 기존 멤버에게 역할을 할당할 수 있습니다.
2. Create Role을 클릭하여 새 역할을 만들거나, 기존 역할을 열어 권한을 편집합니다.
3. 역할의 권한 편집기에서 위 표에 따라 관련 기능을 토글합니다:
   • secret_providers: 이 역할이 기존 자격 증명만 사용하면 되는 경우 read를 선택하고, 자격 증명을 생성, 편집, 삭제할 수도 있어야 하면 manage를 선택합니다.
   • environment_variables: 역할이 시크릿을 참조하는 환경 변수를 생성할 수 있도록 manage를 선택합니다.
4. 역할을 저장합니다.
5. 동일한 Roles 페이지(또는 조직 Members 목록)에서 해당 멤버에게 역할을 할당합니다.

​

환경 변수에서 시크릿 참조하기

공급자 자격 증명이 존재하고 역할에 적절한 권한이 있으면, 모든 환경 변수에서 관리되는 시크릿을 참조할 수 있습니다. CrewAI Platform에서 Environment Variables로 이동하여 Add Environment Variables를 클릭합니다. 폼을 작성합니다:

• Key — 환경 변수의 이름입니다. 문자나 밑줄로 시작해야 하며, 문자, 숫자, 밑줄만 포함해야 합니다. 관례적으로 대문자로 작성합니다(예: OPENAI_API_KEY).
• Value Source — 값의 출처를 선택합니다:
  • Direct Value — 직접 입력하는 평문 값입니다. 공급자를 사용하고 싶지 않을 때 사용합니다.
  • Use AWS default (또는 공급자에 해당하는 항목) — 해당 공급자 유형에서 기본값으로 표시된 자격 증명을 사용합니다.
  • 특정 명명된 자격 증명 — 이름으로 자격 증명을 선택합니다. 동일한 공급자에 대해 여러 자격 증명(예: aws-prod와 aws-staging)이 있고 하나를 명시적으로 선택하려는 경우에 사용합니다.
• Secret Name — 공급자의 시크릿 이름입니다. 자격 증명이 선택되면 이 필드에서 자동 완성을 제공합니다: 입력을 시작하면 CrewAI Platform이 일치하는 시크릿 이름을 공급자에 쿼리합니다. 구조화된(JSON) 시크릿에서 단일 필드를 추출하려면 secret-name#json_key 구문을 사용합니다. 예를 들어, {"username": "...", "password": "..."} 값을 가진 시크릿 database-credentials가 있다면, database-credentials#password로 참조하여 비밀번호만 주입할 수 있습니다.
  Azure Key Vault 참고: Azure 시크릿 이름에는 밑줄을 포함할 수 없습니다. CrewAI Platform은 Azure를 호출할 때 Secret Name 필드의 밑줄을 자동으로 하이픈으로 변환합니다(예: db_password는 db-password로 전송됨).

Create를 클릭하여 변수를 저장합니다.

​

작동 여부 검증

엔드 투 엔드 검증 방법:

1. 다른 환경 변수와 동일한 방식으로 자동화, Crew 또는 배포에서 환경 변수를 참조합니다.
2. 자동화를 배포합니다.
3. 실행을 트리거하고 성공적으로 완료되는지 확인합니다.

​

로테이션 동작은 자격 증명 경로에 따라 다릅니다

배포 또는 실행이 시크릿 관련 오류로 실패하면 가장 일반적인 원인을 확인하세요:

​

다음 단계

• Secrets Manager 개요로 돌아가기
• 정적 자격 증명: AWS · GCP
• Workload Identity (로테이션 인식): AWS · GCP