@h6s-ai/web

브라우저에서 자격증명 등록을 처리하는 vanilla JavaScript SDK입니다. 파트너 페이지 위에 managed 전체화면 iframe을 열어 end-user가 직접 자격증명을 입력할 수 있게 합니다.

설치

npm i @h6s-ai/web

빠른 시작

import { openRegistration } from "@h6s-ai/web/managed";

openRegistration({
  sessionToken, // 백엔드에서 발급받은 1회용 토큰
  onSuccess: ({ sessionId, connectionId }) => {
    // 등록 완료 후 세션 상태를 갱신합니다
  },
  onExit: ({ reason }) => {
    // reason 별 후속 처리를 합니다
  },
});

openRegistration() 은 fixed 전체화면 overlay iframe을 열고, 등록이 끝나면 콜백으로 결과를 돌려줍니다. 인증서와 기관 로그인 입력값은 end-user 브라우저에서 처리되며 파트너 서버를 거치지 않습니다.

공동인증서 에이전트 설치 URL

import { getCertificateAgentDownloadUrl } from "@h6s-ai/web";

const href = getCertificateAgentDownloadUrl();
const macHref = getCertificateAgentDownloadUrl({ platform: "macos" });

현재 브라우저의 플랫폼을 자동 감지합니다. 모바일·서버 환경처럼 설치 파일이 없는 경우에는 null 을 반환합니다.

managed iframe

managed 등록 화면은 @h6s-ai/web/managed 서브패스로 가져옵니다.

import { openRegistration } from "@h6s-ai/web/managed";

openRegistration({
  sessionToken,
  onSuccess: ({ sessionId }) => {},
  onExit: ({ reason }) => {},
});

• openRegistration() 은 항상 fixed 전체화면 overlay iframe을 엽니다.
• onSuccess 는 sessionId, connectionId, registrationKind, providerCode, clientReferenceId 를 전달합니다.

CDN <script>로 로드하면 전역 window.h6s에 managed 등록 화면과 에이전트 설치 URL 헬퍼가 노출됩니다. 자세한 내용은 Vanilla 가이드에서 확인할 수 있습니다.

sessionToken 은 백엔드에서

sessionToken 은 브라우저에서 만들지 않습니다. 파트너 백엔드가 API 키로 발급한 1회용 토큰을 받아 SDK에 전달합니다. 발급 호출과 옵션은 SDK 가이드에 정리되어 있습니다.