시작하기
연동 / SDK
사용자 인증
기업 확인
거래 모니터링
변경 내역범위 지정 액세스가 도입되기 전에 생성된 키는 전체 액세스 권한을 계속 유지합니다.
액세스 권한을 수정하기 전까지는 이러한 키에 아무런 변화가 없습니다.
키 찾는 위치
비즈니스 콘솔에서 애플리케이션을 선택한 다음 개발자 > API 키를 엽니다. 목록에는 애플리케이션의 모든 키가 상태, 지난 30일 동안의 요청 수, 생성자, 액세스 권한, 마지막 사용 시점과 함께 표시됩니다. 키를 클릭하면 오른쪽에서 미리 볼 수 있으며, 키의 전체 페이지를 열면 사용량, 액세스 권한, 최근 요청, 빠른 시작 스니펫, 활동 내역을 확인할 수 있습니다. 키는 하나의 애플리케이션에 속하며 해당 애플리케이션에서만 작동합니다. 키는 애플리케이션의 환경을 따릅니다. 샌드박스 애플리케이션의 키로는 과금되는 인증이 생성되지 않습니다.리디렉션 URL 및 허용 도메인
개발자 > API 키 > 리디렉션 및 도메인을 열면 선택한 애플리케이션과 환경에 대해 두 가지 목록을 설정할 수 있습니다.
허용 도메인 목록에 항목이 있으면, 세션 생성은 목록에 없는
callback을 400 오류와 함께 거부합니다.
목록이 비어 있으면 제한이 없습니다.
서버 간 호출은 영향을 받지 않습니다.
키 생성
1
세부 정보
키를 사용할 서비스의 이름으로 키 이름을 짓고 만료 시점을 선택합니다. 만료 없음, 30일, 90일, 1년 또는 직접 고른 날짜 중에서 고를 수 있습니다.
만료된 키는 해당 날짜가 끝나는 시점(UTC 기준)에 작동을 멈춥니다.
2
접근
프리셋에서 시작한 다음 리소스별로 세부 조정합니다.
이 키는 여기서 설정한 범위를 넘어서는 작업을 절대 할 수 없습니다.
3
검토
키를 배포하기 전에 콘솔이 키로 할 수 있는 작업과 할 수 없는 작업을 명확하게 보여 줍니다.
4
시크릿 키
시크릿을 복사해 시크릿 관리 도구에 보관합니다.
전체 시크릿이 표시되는 시점은 이때뿐입니다.
시크릿을 잃어버렸다면 키를 교체하여 새 시크릿을 발급받으십시오.
프리셋
리소스
읽기는 리소스에 대한GET 요청을 의미하며, 쓰기는 POST, PUT, PATCH, DELETE 요청도 포함합니다.
사용자 지정 접근 권한을 가진 키는 공개 API에서 작동합니다. 세션, 사용자, 기업, 거래, 워크플로, webhook endpoint와 단독 검사가 여기에 해당합니다.
Business Console에서만 사용하는 endpoint는 이 키에
403을 반환합니다. 이러한 endpoint에는 전체 접근 키가 필요합니다.
미디어 읽기 권한이 없는 키도 세션 결정을 받지만, 모든 이미지, 비디오 및 PDF URL 값은 null로 설정됩니다. PDF 보고서 endpoint는 403을 반환합니다.
세션 쓰기 권한이 없는 키는 세션의 인증 링크나 세션 token을 절대 받지 못합니다. 이 링크나 token을 가진 사람은 최종 사용자를 대신해 인증을 완료할 수 있기 때문입니다. 해당 필드는 null로 반환됩니다.
같은 이유로 send_verification_link: true를 사용해 사용자를 생성하려면 사용자 쓰기 권한 외에 세션 쓰기 권한도 필요합니다. 이 호출은 세션을 생성하고 그 링크를 이메일로 보내기 때문입니다.
권한이 없으면 호출은 403을 반환하며 아무것도 생성되지 않습니다.
제한
워크플로나 승인된 세션으로 제한된 키는 세션 endpoint에서 작동하며, 이 제한을 적용할 수 있습니다.
사용자, 기업, 거래 또는 분석에는 접근할 수 없으며, 단독 검사도 실행할 수 없습니다.
API가 범위 지정 키에 응답하는 방식
세션 목록에는 키의 제한이 허용하는 세션만 반환됩니다.
접근 권한 편집
키의 메뉴, 미리보기 또는 페이지를 열고 접근 권한 편집을 선택합니다. 프리셋, 리소스, 제한 또는 만료를 변경한 다음, 변경되는 부분만 변경 전과 후를 비교하여 검토합니다. 시크릿은 그대로 유지되므로 재배포할 필요가 없으며, 새 접근 권한은 1분 이내에 적용됩니다. 기본 시크릿은 항상 전체 접근 권한을 가지며 편집할 수 없습니다.키 교체
키를 교체하면 키의 시크릿이 바뀝니다. 새 시크릿은 한 번만 표시되며, 현재 시크릿은 24시간 동안 계속 작동하므로 다운타임 없이 새 시크릿을 배포할 수 있습니다. 그 이후에는 이전 시크릿으로 보낸 모든 요청이401을 반환합니다.
기본 시크릿도 같은 방식으로, 같은 24시간 중첩 기간을 두고 교체됩니다.
키 폐기
키를 폐기하면 즉시 중단됩니다. 이 키로 보낸 모든 요청은401을 반환합니다.
폐기는 되돌릴 수 없습니다.
기본 시크릿은 폐기할 수 없으며, 대신 교체해야 합니다.