API 키
조직의 API 키를 생성, 검토, 폐기합니다.
API 키를 사용하면 다른 시스템이 워크플로를 다음을 통해 시작할 수 있습니다 파트너 API — 실행이 이루어지려면 아무도 Morphic를 열 필요가 없습니다. API 키 탭은 관리자에게만 표시됩니다.
바로 이동: studio.morphic.com/settings/api-keys
키는 조직에 속합니다
키를 만든 사람이 아니라 조직에 속합니다. 그 사람이 떠나도 계속 작동하며, 모든 관리자는 목록에서 이를 보고 취소할 수 있고, 이 키로 시작된 모든 실행은 조직에 청구됩니다.
키 만들기
탭을 여세요
조직 드롭다운(왼쪽 상단의 Morphic 로고)을 열고, 설정을 선택한 다음 API 키 왼쪽 사이드바에서.
새 키를 클릭하세요
한 달 뒤에도 알아볼 수 있는 이름을 지정하세요 — 'key 2'가 아니라, 이 키가 사용되는 시스템 이름으로 하세요.
범위를 선택하세요
세 가지가 제공되며, 파트너 통합에는 보통 세 가지 모두가 필요하므로 양식은 세 가지가 모두 선택된 상태로 시작합니다. 키가 수행할 수 없게 할 작업은 선택 해제하세요.
workflows:read— 워크플로와 그 입력을 읽기runs:write— 실행을 시작하고 웹훅 엔드포인트를 등록하기runs:read— 실행 상태와 완료된 자산을 읽고 웹훅 엔드포인트를 나열하기
특정 워크플로로 제한하기
선택 사항이지만 해둘 가치가 있습니다. 체크하세요 이 키를 특정 워크플로로 제한 한 다음 선택하세요. 그 외의 작업은 실행이 거부되므로, 키가 유출되더라도 피해를 제한할 수 있습니다. 체크하지 않으면 이 키는 조직이 실행할 수 있는 모든 워크플로를 실행할 수 있습니다.
크레딧 한도를 설정하세요
총 한도는 필수입니다 — 키에는 절대 초과할 수 없는 상한이 있어야 합니다. 일별 및 월별 상한은 선택 사항이며, 해당 기간에 한도를 두지 않으려면 비워 두세요.
통합이 다시 확인되기 전까지 지출할 수 있어야 하는 금액을 기준으로 총 한도를 정하세요. 실제로 쓸 금액이 아니라 차단 장치이기 때문입니다. 기간별 한도는 총 한도보다 높을 수 없습니다. 총 한도가 먼저 적용되기 때문입니다.
키로 시작된 실행의 크레딧은 조직에 청구되며 해당 키의 한도에 포함됩니다. 나중에 누군가 채팅에 들어와 이어받더라도, 키가 시작한 실행은 계속 그 키에 대해 차감됩니다. 그렇지 않으면 동료가 질문 하나를 답한 것만으로 나머지 실행 비용이 조직의 일반 풀로 넘어가게 됩니다. 그 사람에게 자신의 크레딧 한도가 있다면 그것도 여전히 적용됩니다.
하루는 UTC 기준 하루이고, 한 달은 UTC 기준 달력 월입니다. 키의 한도를 초과하게 되는 청구는 거부되며, 메시지에는 키와 도달한 한도가 표시됩니다.
만료 기간을 선택하세요
없음, 30일, 90일 또는 1년. 만료된 키는 자동으로 인증이 중단되며, 이는 가장 저렴한 순환 방식입니다.
비밀값 복사
비밀 값이 표시됩니다 한 번. Morphic는 해당 값의 해시만 보관하므로 다시 표시할 수 없습니다. 대화 상자를 닫기 전에 비밀 관리자에 복사하세요.
키를 가진 사람은 누구나 조직의 크레딧을 사용하는 실행을 시작할 수 있습니다. 절대 커밋하지 말고, 브라우저에 넣지 말고, 이메일이나 채팅으로 보내지 마세요. 유출되면 취소하세요 — 그래서 이 탭이 있는 것입니다.
목록에 표시되는 항목
각 키에는 이름, 실사용 키인지 테스트 키인지 여부, 비밀 값의 앞부분(자신의 기록과 대조하기에 충분한 정도), 범위, 실행할 수 있는 워크플로 수, 크레딧 한도, 마지막 사용 시점이 표시됩니다. 만료되었거나 취소된 키도 목록에 남아 있으므로 어떤 일이 있었는지 확인할 수 있습니다.
조직은 최대 10개까지 개를 한 번에 보유할 수 있습니다. 만료되었거나 취소된 키는 이에 포함되지 않습니다.
키의 크레딧 한도를 변경하기
- 목록에서 키를 찾으세요.
- 옆의 '…' 메뉴를 클릭하고 선택하세요 한도 수정.
- 총 한도, 일별 또는 월별 한도를 변경하고 — 한도를 없애려면 비워 두고 — 저장하세요.
새 한도는 키의 다음 청구 시점부터 적용되며, 이미 시작된 실행에도 적용됩니다. 따라서 실행이 키의 한도에서 멈췄을 때 이 방법으로 수정할 수 있으며, 취소된 키에도 적용됩니다. 해당 키의 실행은 여전히 그 키에 대해 차감되므로, 한도를 낮추는 것이 이를 멈추는 방법입니다.
키 취소하기
- 목록에서 키를 찾으세요.
- 옆의 '…' 메뉴를 클릭하고 선택하세요 키 취소.
- 확인하세요.
이를 사용한 호출은 몇 초 내로 실패하기 시작합니다. 이미 진행 중인 실행은 완료되며, 그에 대한 청구는 계속됩니다. 취소는 되돌릴 수 없습니다 — 교체하려면 먼저 대체 키를 만들고, 트래픽을 새 키로 옮긴 다음, 이전 키를 취소하세요.
비용이 표시되는 위치
API를 통해 시작된 실행의 크레딧은 조직에 청구되며 이를 시작한 키에 귀속됩니다. 아래에서 확인하세요 청구 및 사용량 → 크레딧 활동.