SSO 로그인
이용 대상
이 문서는 조직이 SSO(단일 로그인)를 구성한 배포에서만 해당합니다. 조직이 SSO 를 사용하지 않는 배포라면 로그인 메뉴 자체가 동작하지 않으며, 이 문서의 절차는 해당 사항이 없습니다. 이 경우 별도 로그인 없이 코드스페이스에서 시작하기 절차를 바로 따르면 됩니다.
로그인 절차
- 커맨드 팔레트(F1)를 엽니다.
GenOS: Sign in (SSO)명령을 실행합니다.- 브라우저에 조직 로그인 페이지(예: Keycloak 의 "Sign in to your account" 화면)가 열립니다.
- 조직 계정으로 로그인합니다.
- "GenCode - Authentication Success" 페이지가 표시되면 로그인이 완료된 것입니다. 이 창은 닫아도 됩니다.
브라우저 확인창(code-server)
code-server(웹) 환경에서는 로그인 페이지가 열리기 전에 "Do you want ... to open the external website?" 형태의 확인 다이얼로그가 먼저 뜰 수 있습니다. 이 다이얼로그의 Open 을 클릭해야 조직 로그인 페이지로 넘어갑니다.
로그아웃
커맨드 팔레트(F1)에서 GenOS: Sign out (SSO) 명령을 실행하면 로그아웃됩니다.
다른 계정으로 다시 로그인하려면 로그아웃 후 위 절차를 다시 따르세요.
막혔을 때
로그인 절차를 모두 마쳤는데도 이후 요청이 401 오류로 실패한다면 트러블슈팅 §401 문서를 참고하세요.
제약
조직이 SSO 를 필수로 적용(강제)한 배포에서는 로그인 전 요청이 인증 오류(401)로 실패합니다. 로그인 메뉴만 구성된 배포에서는 로그인 없이도 사용될 수 있습니다. 로그인 세션이 어떻게 유지·만료되는지는 SSO 세션 관리 문서에서 다룹니다.