# 로그인 연동
> Source: https://docs.wrks.ai/admin-guide/integrations/sso · Last updated: 2026-11-05
웍스AI를 도입하는 기업들이 **소속 임직원들의 로그인**을 처리하는 방식은 다음 **여섯 가지 중 선택** 가능합니다.
### 1. MS Entra ID 로그인을 통한 SSO
MS Entra ID (구, AD)를 이용중인 기업들은 별도의 절차 연동 없이 임직원들이 웍스AI 메인 화면에서 '**Microsoft로 시작하기**'를 눌러 **회사 계정으로 자동 로그인** 할 수 있습니다.
저희 **** 메일로 **회사 이메일 도메인 주소(@company.com)**를 알려주세요. 그러면 MS Entra ID를 이용해 회사 이메일로 로그인하는 모든 임직원들이 **자동으로 여러분의 회사 환경으로 접속**되도록 설정해 드릴 수 있습니다.
직원들이 Microsoft 계정으로만 들어오게 안내하고 싶으면 아래 주소를 사내에 공지하세요. 이 주소를 열면 바로 Microsoft 로그인 화면으로 가요. 다른 로그인 방법을 막는 설정은 아니에요. 막아야 한다면 고객지원으로 문의해 주세요.
`https://wrks.ai/ko/signin/id/우리회사영문이름` (예: `https://wrks.ai/ko/signin/id/ai3`)
### 2. 네이버 웍스 로그인
네이버 웍스를 쓰는 회사는 직원이 `네이버 웍스로 시작하기` 를 눌러 회사 계정으로 로그인하게 할 수 있어요. 회사별로 먼저 등록해야 해서, **** 로 문의한 뒤 진행해 주세요.
### 3. 그룹웨어로부터의 정보 제공을 통한 SSO
MS Entra ID를 사용하지 않고 **자체 그룹웨어 로그인**을 이용하고 있는 기업들도 웍스AI와의 자동 로그인을 구현하실 수 있습니다. [API 이용가이드의 '암호화 코드 인증'](https://wrks.ai/ko/docs/auth) 페이지를 참고해 주세요.
**그룹웨어에서 웍스AI로 가는 링크**를 추가해 두시고, 임직원이 **해당 링크를 클릭**하게 되면 임직원의 **암호화된 인사정보**가 **웍스AI에 제공되어 인증**되는 방식입니다.
이 방식을 사용하시는 경우, **최초 1회 임직원이 웍스AI에 접속**하게 되면 '**개인정보 제공 동의**' 창이 떠서 **임직원이 동의하는 경우에만** 자동 로그인이 이루어지게 됩니다. 위 [**API 이용가이드**](https://wrks.ai/ko/docs/auth)를 참고하여 기업들이 직접 개발 연동해 주시면 됩니다. 암호화에 쓰는 키(Key)와 IV는 웍스AI가 회사별로 드려요. **** 로 요청해 주세요. 조직도까지 맞추려면 `관리자 > API 키 관리` 에서 API 키를 발급해 [구축 가이드](https://wrks.ai/ko/docs/sync-guide)를 따라 주세요.
* 암호화 코드는 만든 시각 기준 **앞뒤 3분 안에만** 쓸 수 있어요. 로그인할 때마다 새로 만들어 주세요.
* 회사 정책상 이메일을 보낼 수 없으면 이메일 자리에 **사원번호**를 넣을 수 있어요.
* 이 방식은 기존 로그인 방식을 끄지 않아요. 링크를 받지 않은 직원은 아이디·비밀번호로 계속 로그인할 수 있어서 **일부 직원으로 먼저 시험**해 볼 수 있어요.
### 4. 회사 이메일로 직접 가입/로그인
위 1번 방식은 MS Entra ID를 쓰고 있는 기업만 이용 가능하고, 위 3번 방식은 별도 개발이 필요하기 때문에 **많은 회사들은 이 4번 방식을 가장 많이 이용**하고 있습니다.
이 방식은 **모든 소속 임직원이 최초 1회 웍스AI 서비스에 회사 이메일로 직접 가입**해 주어야 하는 불편은 있지만 별도 개발이 필요없어 **가장 쉬운 연동 방식**입니다.
저희 **** 메일로 사용하고 계시는 **회사 이메일 도메인 주소**(@company.com)를 알려주세요. 그러면 저희가 **회사 계정에 해당 도메인을 연결**해 드려요.
그 이후 **임직원들에게 공지**하시고 임직원들이 **웍스AI에 회사 이메일로 가입**하시면 자동으로 **회사 계정에 접속**돼 이용하실 수 있게 됩니다. 퇴사시 회사 이메일을 못쓰시게 되실 것이므로 이 방식은 앞서 다른 1·3번 방식과 동일하게 **입/퇴사자도 자연스럽게 관리 가능**한 방식입니다.
### 5. 임직원 일괄 초대 방식
100명 미만의 중소 규모 조직에 가장 적합한 방식입니다. 관리자가 서비스 우측 상단 **\[관리자]** 내 **\[사용자 관리]** 메뉴에서 파란색 '**사용자 신규 초대**' 버튼을 눌러 **임직원들을 직접 초대**하는 방식입니다.
사용자 신규 초대 창이 뜨면 두번째 탭 '**일괄 대량 초대**'를 눌러보세요. 여기서 '**초대 양식 다운로드**' 버튼을 누르시면 **임직원 초대 양식 CSV 파일**을 내려 받으실 수 있어요.
CSV 파일을 열어보면 아래와 같은 예제 내용이 보입니다. 이 내용(이순신, 강감찬, 권율)을 모두 지우고 **우리 회사에 초대할 사람들의 정보를 각 행으로 분리해 쭉 추가**해 주세요. 각 행에는 **이름, 이메일, 권한**을 넣고, 필요하면 **사번, 부서코드**도 넣어요.
**대부분 사용자의 권한은 모두 '일반 사용자'**로 입력해 주시면 됩니다. 그 중 일부 관리자로 지정할 사용자만 '**최고 관리자**' 또는 '**워크스페이스 관리자**'로 입력해 주시면 됩니다.
이렇게 입력을 완료한 **CSV 파일을 저장**하신 후 위 '**일괄 대량 초대**' 탭에 **파일을 업로드** 해주시면 파일에 추가된 모든 사용자의 이메일로 웍스AI **우리 회사 환경으로의 초대 메일이 발송**됩니다. 그러면 초대 메일의 내용에 따라 **각자 가입**해 주시면 **회사 환경을 이용**할 수 있게 됩니다.
초대 메일을 보냈는데 **아직 가입하지 않은 임직원**이 있다면, 같은 사용자 신규 초대 창의 세번째 탭 '**초대 이메일 재발송**'에서 초대 이메일을 다시 보내실 수 있어요.
### 6. 사용자 일괄 등록 방식 (초대 없이 자동가입)
초대 메일을 보내고 임직원들이 각자 가입하기를 기다릴 필요 없이, 관리자가 **계정을 한 번에 만들어 두는 방식**도 있습니다. **\[관리자]** 내 **\[사용자 관리]** 메뉴에서 '**사용자 일괄 등록**' 버튼을 누르시면 **CSV 파일로 일괄 등록(자동가입)** 할 수 있어요.
CSV 각 행에는 **이메일(필수), 이름(필수), 권한(필수)** 을 넣어주세요. 권한에는 세 값 중 하나를 `일반사용자`·`워크스페이스관리자`·`최고관리자` 처럼 붙여 써요(띄어 써도 인식돼요). SSO로 로그인하는 회사라면 내려받은 양식의 `client_uid` 칸(화면 안내표에는 `uid` 로 보여요)에 로그인 ID를 넣을 수 있어요. 비워 둬도 돼요. **비밀번호는 선택** 항목이고, 비워두시면 등록 시 정한 **기본 비밀번호**가 적용됩니다. 등록할 **워크스페이스**를 고르고 파일을 올리시면, 임직원들은 **별도의 초대 과정 없이 초기 비밀번호로 즉시 로그인**해 바로 이용할 수 있게 됩니다.
5번 방식의 '**일괄 대량 초대**' 탭은 **초대 메일을 보내 각자 가입하게 하는 기능**이고, '**사용자 일괄 등록**' 버튼은 **초대 없이 계정을 바로 만드는(자동가입) 별개 기능**이에요. 두 기능의 자세한 사용법은 [사용자 관리](https://docs.wrks.ai/admin-guide/admin-org/users) 페이지를 참고해 주세요.