SSO 연동 가이드

파트너사 인증 서버와 아키스케치를 SSO로 연동하는 방법을 안내해요.

아키스케치 SSO(Single Sign-On)를 사용하면 파트너사의 자체 인증 시스템으로 대시보드에 로그인할 수 있어요. 파트너 서버가 검증 토큰을 발급하고, 아키스케치가 이를 파트너 서버에 확인하는 방식이에요.

---

1

아키스케치 기업 서비스 접속하기

아키스케치와 계약한 다음에 아키스케치 기업 서비스에 로그인해주세요.

설정 > 기업 설정 > 개발자 설정으로 이동한 뒤 'View/Update' 버튼을 클릭해주세요.

필드	설명	필수	예시
Verification URL	파트너사 인증 서버의 검증 URL (GET 방식만 지원)	O	https://your-service.com/oauth2/user
Email Key	검증 API 응답에서 이메일 필드명 (아키스케치 email에 매핑)	O	email
Name Key	검증 API 응답에서 이름 필드명 (아키스케치 name에 매핑)	O	name
UID Key	검증 API 응답에서 사용자 고유 ID 필드명 (아키스케치 uid에 매핑)	X	id
Avatar Key	검증 API 응답에서 아바타 이미지 URL 필드명 (아키스케치 avatarImage에 매핑)	X	profileImageUrl
Use GET with Bearer Token	검증 토큰 전달 방식. true: Authorization 헤더 Bearer, false: Query Parameter (기본값)	X	false
Request Param Key	Use GET with Bearer Token이 false일 때 사용할 Query Parameter 이름	X	token

아키스케치가 파트너사 검증 서버를 호출할 때, 설정에 따라 두 가지 방식으로 토큰을 전달해요.

• Query Parameter 방식 (기본): GET {verificationUrl}?{paramKey}={verifyToken}

• Bearer Token 방식: GET {verificationUrl} + Authorization: Bearer {verifyToken}

2

연동 흐름 확인하기

1. 사용자가 파트너사 서비스에서 로그인해요.

2. 파트너사 서버가 verifyToken을 생성하고, 아키스케치 로그인 API를 호출해요.

3. 아키스케치가 등록된 검증 URL로 verifyToken을 전달해 사용자 정보를 확인해요.

4. 검증에 성공하면 사용자를 생성(신규)하거나 업데이트(기존)하고 토큰을 반환해요.

5. 발급받은 토큰으로 대시보드에 인증할 수 있어요.

3

대시보드 리다이렉트하기

발급받은 토큰으로 대시보드에 바로 인증 리다이렉트할 수 있어요.

https://{enterprise-subdomain}.archisketch.com/auth/sign-in?access_token={accessToken}&refresh_token={refreshToken}

SSO 연동에 대한 질문이나 건의사항이 있다면 연동/개발 문의에 문의해 주세요.