본문으로 건너뛰기

시크릿

데이터 → 시크릿에서 비밀번호·API 키 같은 인증 값을 키-값 묶음으로 관리합니다. 목록에는 조회 권한이 있는 시크릿만 표시되며 저장한 값은 다시 확인할 수 없습니다.

시크릿이 없는 상태의 목록과 생성 버튼

목록에서 찾기

  • 범위 필터: 전체 / 전역 / 컬렉션으로 목록을 좁힙니다.
  • 검색: 이름·설명·컬렉션·키 이름으로 찾습니다. 키 값은 검색하거나 다시 표시하지 않습니다.
  • 조회 권한: 목록에는 로그인한 사용자가 조회할 수 있는 시크릿의 이름·설명·키 이름 같은 메타데이터만 표시됩니다. 저장된 값은 조회 권한이나 사용 권한이 있어도 표시되지 않습니다.

시크릿 만들기

시크릿은 관리자와 매니저가 만듭니다. 컬렉션을 지정하지 않는 전역 시크릿은 관리자만 만들 수 있습니다.

  1. 시크릿 만들기를 누릅니다.
  2. 이름과 설명을 입력합니다.
  3. 컬렉션 범위 시크릿이면 컬렉션을 선택합니다. 전역으로 만들려면 컬렉션을 비웁니다.
  4. 키 이름과 값을 하나 이상 입력합니다. 하나의 시크릿에 여러 키를 묶을 수 있습니다.
  5. 만들기를 누릅니다.
값은 저장 후 다시 표시되지 않습니다

저장 전에 값을 안전한 위치에 별도로 보관합니다. 화면에는 키 이름과 값의 설정 여부만 남습니다.

키 관리

시크릿을 열고 키 관리에서 다음 작업을 수행합니다.

  • 키 추가: 새 키 이름과 값을 입력합니다.
  • 값 교체: 기존 키에 새 값을 저장해 인증 정보를 회전합니다. 이전 값은 확인하거나 되돌릴 수 없습니다.
  • 키 삭제: 더 이상 사용하지 않는 키를 삭제합니다. 해당 키를 참조하는 데이터 연결이나 도구는 실행에 실패할 수 있습니다.

키를 교체하거나 삭제하기 전에 데이터 연결과 도구에서 사용하는 참조를 확인합니다.

사용 권한 관리

편집 화면의 사용 권한에서 사용자나 그룹을 검색해 시크릿 사용 권한을 부여하거나 회수합니다. 이 권한은 데이터 연결이나 도구가 저장된 값을 참조하도록 허용하며 시크릿의 조회·편집 권한과는 별도로 적용됩니다.

컬렉션에 속한 시크릿을 사용하려면 대상이 해당 컬렉션의 소유자이거나 사용 권한을 가지고 있어야 합니다. 현재 계정이 컬렉션 권한을 관리할 수 있으면 포털이 상위 컬렉션의 사용 권한을 먼저 자동으로 부여합니다. 역할과 사용 권한의 관계는 공유 권한의 사용 권한에서 확인합니다.

데이터 연결에서 기존 시크릿을 사용하려면 시크릿 참조 사용을 선택한 뒤 시크릿과 키를 차례로 고릅니다. 참조 문자열을 직접 입력하지 않습니다. 커넥터를 편집할 때 자격 증명 필드를 비워 두면 기존 참조가 유지되고, 다른 시크릿·키를 고르면 교체됩니다.

자동 관리 시크릿

일부 데이터 연결은 자격 증명을 저장하면서 전용 시크릿을 자동으로 만듭니다. 이러한 시크릿은 소유 데이터 연결에서 값을 교체하거나 연결을 삭제해 관리합니다. 시크릿 화면에서는 직접 편집하거나 삭제할 수 없습니다.

삭제

일반 시크릿은 행의 삭제 또는 목록의 일괄 작업으로 삭제합니다. 삭제하면 키 값과 참조를 복구할 수 없으며 해당 시크릿을 사용하는 작업이 실패할 수 있습니다.

일괄 삭제에서는 데이터 연결이 자동으로 관리하는 시크릿을 선택할 수 없습니다. 나머지 선택·페이지 이동·부분 실패 규칙은 첫 화면의 관리 목록 공통 동작에서 확인합니다.

다음 단계