이 페이지에서
> 리소스 > 문서 > api > API 키

API 키

ProcessMind에서 API 키 관리하기

ProcessMind API를 연동하려면 API 키를 생성하고 관리해야 합니다. API 키를 발급하고 사용하며 안전하게 보관하는 방법을 알아보세요.

ProcessMind 계정 설정에서 “API 키” 섹션으로 이동합니다. 여기서 새 환경 API 키 버튼을 클릭해 새 API 키를 만들 수 있습니다. 나중에 식별할 수 있도록 키 이름을 지정하세요.

API 키 만들기

image

애플리케이션이나 서비스별로 API 키를 여러 개 만들 수 있습니다. 각 키를 개별적으로 관리할 수 있으므로 다른 연동에 영향을 주지 않고 필요한 키만 폐기할 수 있습니다. 키가 발급되면 복사해 안전한 곳에 보관하세요. 보안상 키는 생성할 때 한 번만 표시됩니다.

image

warning

API 키를 안전하게 보관하고 클라이언트 측 코드나 공개 저장소에 노출하지 마세요. 키가 유출되면 즉시 폐기하고 새 키를 발급하세요.

조직 API 키

조직 관리자는 같은 페이지에서 조직 API 키도 만들 수 있습니다. 환경별 키와 달리 조직 키는 조직의 모든 환경(테넌트)에서 사용할 수 있어 하나의 연동으로 전체 환경을 지원할 수 있습니다. 조직 키는 다음 작업에 사용하세요.

  • 환경 API 키 발급: External API를 통해 테넌트 범위의 키를 만들고, 수정하고, 삭제합니다(/v1/tenant/{tenantId}/api-keys).
  • 일회용 로그인 링크 발급: 사용자가 인증된 상태로 자체 제품에서 ProcessMind로 바로 이동하도록 합니다(/v1/tenant/{tenantId}/users/{userId}/login-token).

권한 범위

권한 범위 허용 작업
read 테넌트 데이터 조회(목록 및 단건 조회 엔드포인트). 기본적으로 사용 설정됩니다.
write 테넌트 데이터 생성, 수정 및 삭제. 기본적으로 사용 설정됩니다.
uploadData datatable 업로드용 사전 서명 URL 요청. 기본적으로 사용 설정됩니다.
sessions 일회용 로그인 전달 토큰 발급. 기본적으로 사용 중지됩니다.

로그인 전달이 필요한 키에만 sessions를 사용 설정하고, 해당 키는 비밀번호처럼 안전하게 관리하세요. 발급된 토큰을 사용하면 비밀번호 입력 없이 사용자가 로그인됩니다. 조직 키는 조직 내 모든 환경의 사용자를 대상으로 토큰을 발급할 수 있으며, 환경 키는 해당 환경의 사용자만 대상으로 합니다.

일회용 로그인 전달

POST /v1/tenant/{tenantId}/users/{userId}/login-token은 사용자, 환경 및 조직에 연결된 일회용 토큰(유효 기간 60초)과 url을 반환합니다. 사용자의 브라우저를 해당 URL로 보내면 이메일 링크나 사용자 가장 없이 사용자의 세션으로 ProcessMind에 접속합니다. 요청 본문에 path를 선택적으로 전달하면 특정 페이지로 바로 이동할 수 있습니다. 키에 sessions 권한 범위가 있어야 하며, 키가 접근할 수 있는 테넌트의 사용자만 토큰을 발급할 수 있습니다.

토큰 발급은 감사 로그에 기록되고 엄격한 요청 횟수 제한이 적용됩니다. 키가 비활성화되거나 사용자의 접근 권한이 사라지면 즉시 차단됩니다. 토큰은 한 번만 반환되며 로그에 기록되지 않습니다.

관련 항목

관련 문서

더 나은 프로세스를 설계하고, 연결된 아키텍처를 구축해 관리하세요.

신용카드 등록이나 대기 없이 바로 이용할 수 있습니다. 조직의 업무 방식을 명확하고 유기적으로 연결된 프로세스 설계로 바꿔 보세요.

프로세스 아키텍처를 구축하고, 소유권과 통제 기준을 정립하며, 모든 계층의 역할과 책임을 조율하세요.

무료 체험을 시작하고 프로세스를 관리·운영하고 지속적으로 개선할 수 있는 신뢰할 만한 기반을 마련하세요.

오늘 무료 체험 시작하기