API 설정 가이드

라이선스 관리 하위 도메인을 사용하면 라이선스를 쉽게 관리할 수 있으며, 새 라이선스 파일 업로드, 현재 활성 라이선스 정보 조회, 기존 라이선스 삭제가 가능합니다.

유효한 라이선스를 받으려면 문의해 주세요.

라이선스 관리 API 설정​

1. 활성 라이선스 업로드​

이 API는 Glasswall Halo의 진입점을 통해 접근할 수 있습니다. 이 진입점은 포털과 동일한 ip address/url를 공유합니다.

라이선스 파일을 제출하려면 /API/v1/license 엔드포인트로 post 요청을 보내세요. 요청 본문에는 .lic 형식의 라이선스 파일이 포함된 json을 넣어야 합니다.

-----BEGIN LICENSE FILE-----\n  eyJlbmMiOiJleUprWVhSaElqcDdJbWxrSWpvaU1EYzFZV05sT1RFdFlUaGtP\n  UzAwTVdObUxXRmtNMk10TTJJd01EWXpOakF5WTJRMUlpd2lkSGx3WlNJNklt\n...\nYithdmN6WmVTMitrZGxrKzNwZ0RGTXhueHVpWkNYQUI3RlRrYnB5MkRRPT0i\nLCJhbGciOiJiYXNlNjQrZWQyNTUxOSJ9\n-----END LICENSE FILE-----\n

라이선스가 유효하고 만료일 이내라고 가정하면, API는 라이선스 세부 정보를 포함하는 JSON 본문으로 응답하며, 라이선스 파일 구조의 요약을 제공합니다. 라이선스 세부 정보에 대한 자세한 내용은 여기에서 확인할 수 있습니다.

참고: 한 번에 하나의 활성 라이선스만 허용된다는 점에 유의해 주세요.

license API에서 실패 응답이 반환되는 경우는 일반적으로 라이선스가 유효하지 않거나 만료되었음을 의미합니다. 응답 본문에는 라이선스가 유효성 검사 통과에 실패한 이유를 지정하는 오류 메시지가 포함됩니다. 이러한 상황이 발생하면 당사에 문의해 주세요. 저희 팀이 유효한 라이선스 파일을 받아 프로세스를 성공적으로 다시 시도할 수 있도록 도와드리겠습니다.

2. 올바른 라이선스가 설치되었는지 확인​

활성 라이선스를 업로드하면 응답에 라이선스 세부 정보가 포함됩니다. 이 라이선스 세부 정보를 다시 가져오려면 Step 1에서 언급한 것과 동일한 entry point를 사용하여 /API/v1/license에 get 요청을 보내세요. 라이선스 세부 정보에 대한 자세한 내용은 여기에서 확인할 수 있습니다.

라이선스의 정확성을 보장하려면 라이선스 세부 정보를 확인해 주세요. 특히 daysleft, startdate, entitlements가 구매한 라이선스에 대해 예상한 내용과 일치하는지 확인하세요. 제공된 라이선스가 유효하지 않거나 부정확한 내용이 포함되어 있다고 의심되는 경우 당사에 문의해 주세요.

자세한 내용은 API documentation도 참조해 주세요.

활성 라이선스 업데이트​

라이선스를 업데이트하려면 앞서 새 라이선스를 설치할 때 설명한 것과 동일한 단계를 따르면 됩니다. 새 라이선스를 업로드하면 이전 라이선스가 자동으로 대체되어 새 라이선스가 적용됩니다.

새 라이선스가 적용될 때까지 60초 정도 기다려 주세요.

활성 라이선스 제거​

현재 활성화된 라이선스를 제거하려면 이전 단계와 동일한 entry point를 사용하여 /API/v1/license에 delete 요청을 보내세요. 이 작업은 라이선스를 제거하며 되돌릴 수 없습니다.