인증
모든 Partner API 요청을 조직 API 키로 인증합니다.
모든 요청에는 API 키가 베어러 토큰으로 포함됩니다.
Authorization: Bearer mor_live_7f3c1a9e…키는 조직, 생성한 사람이 아니라 그 사람에게 속합니다. 그 사람이 떠나도 계속 작동하며, 조직의 어떤 관리자도 목록에서 확인하고 취소할 수 있습니다.
키 만들기
설정 열기
Morphic Studio에서 조직 드롭다운(왼쪽 상단의 Morphic 로고)을 열고 설정을 선택합니다.
API 키로 이동
왼쪽 사이드바에서 API 키를 클릭합니다. 이 탭은 관리자만 볼 수 있습니다.
키 만들기
클릭하세요 새 키, 한 달 뒤에도 알아볼 수 있는 이름을 지정하고, 스코프를 선택한 다음, — 영구적으로 둘 필요가 없다면 — 만료일을 설정합니다.
비밀값 복사
비밀값은 한 번만 표시됩니다. Morphic은 이를 해시만 저장하므로 다시 표시할 수 없습니다. 대화상자를 닫기 전에 비밀 관리자에 넣어 두세요.
키를 가진 사람은 누구든 조직의 크레딧을 소모하는 실행을 시작할 수 있습니다. 이를 비밀번호처럼 취급하세요. 절대 커밋하지 말고, 브라우저에 넣지 말고, 이메일이나 채팅으로 보내지 마세요.
스코프
키는 부여된 스코프만 가질 수 있습니다. 그 범위를 벗어난 요청은 다음 오류와 함께 거부됩니다: access_denied.
| 스코프 | 허용 사항 |
|---|---|
workflows:read | 워크플로와 그 입력을 읽기 |
runs:write | 실행을 시작하고, 웹훅 엔드포인트를 등록 및 제거하기 |
runs:read | 실행 상태와 완료된 자산을 읽고, 웹훅 엔드포인트를 나열하기 |
키는 다음으로도 제한할 수 있습니다 특정 워크플로에. 그 밖의 어떤 것을 시작하려고 하면 거부되며, 그 밖의 어떤 것에 대한 실행은 찾을 수 없음으로 처리됩니다. 이는 하나의 통합에만 존재하는 키에 원하는 동작입니다.
환경
접두사는 키가 어느 배포에 속하는지 알려 주므로, 유출된 키는 한눈에 배치 위치를 파악할 수 있습니다. 다른 배포에 제시된 키는 거부됩니다.
| 접두사 | 환경 | 기본 URL |
|---|---|---|
mor_live_ | 프로덕션 | https://api.morphic.com/v1/partner |
mor_test_ | 스테이징, 통합 작업용입니다. 그곳의 실행은 제한되며 데이터는 귀하의 것이 아닙니다 | https://api.morphic.today/v1/partner |
크레딧 한도
모든 키에는 해당 키가 사용할 수 있는 크레딧 상한이 있으며, 이는 생성한 관리자가 설정합니다:
| 한도 | 설정됨? | 의미 |
|---|---|---|
| 총합 | 항상 | 키가 사용할 수 있는 전체 크레딧 |
| 일일 | 선택 사항 | UTC 하루당 크레딧 |
| 월별 | 선택 사항 | UTC 한 달당 크레딧 |
하루는 UTC 하루이고 한 달은 UTC 달력 월입니다. 키가 한도 중 하나를 넘기게 되는 청구는 다음 오류와 함께 거부됩니다: api_key_credit_limit_reached; 오류의 error_attributes.period 에서 어떤 한도인지 알려 줍니다(총, 월간 또는 일일). 이는 조직의 크레딧이 부족한 경우(credits_exhausted)와는 다른 조건이며, 해결 방법도 다릅니다: 관리자가 Studio에서 조직에 충전하는 대신 키의 한도를 올립니다. 키에 남은 여유가 없는 상태에서 시작은 아무것도 가져오기 전에 거부됩니다.
Studio의 채팅에 누군가가 들어와 작업을 넘겨받더라도, 키로 시작한 실행은 계속 그 키의 사용량으로 계산됩니다. 따라서 키의 남은 예산은 자동화된 부분뿐 아니라 실행 전체의 예산입니다.
회전
틈 없이 겹쳐서 교체하세요. 먼저 새 키를 만들고 배포한 뒤, 트래픽이 이동했는지 확인한 다음 이전 키를 취소합니다. 조직은 한 번에 인증할 수 있는 키를 최대 10개까지 보유할 수 있어, 아무도 종료하지 못한 채 쌓여 버리는 덩어리가 되지 않도록 여유 있게 교체할 수 있습니다.
취소는 몇 초 내에 효력을 발휘합니다. 이미 진행 중인 실행은 완료되며, 요금도 계속 부과됩니다.