# 로그인 연동

> Source: https://docs.wrks.ai/admin-guide/integrations/sso · Last updated: 2026-08-24

웍스AI를 도입하는 기업들이 **소속 임직원들의 로그인**을 처리하는 방식은 다음 **네가지 중 선택** 가능합니다.

## 1. MS Entra ID 로그인을 통한 SSO

MS Entra ID (구, AD)를 이용중인 기업들은 별도의 절차 연동 없이 임직원들이 웍스AI 메인 화면에서 '**Microsoft로 시작하기**'를 눌러 **회사 계정으로 자동 로그인** 할 수 있습니다.

<figure><img src="/files/Ucuk7xx8WiJPBuTvpljH" alt="" width="375"><figcaption></figcaption></figure>

저희 **<enterprise@wrks.ai>** 메일로 **회사 이메일 도메인 주소(@company.com)**&#xB97C; 알려주세요. 그러면 MS Entra ID를 이용해 회사 이메일로 로그인하는 모든 임직원들이 **자동으로 여러분의 회사 환경으로 접속**되도록 설정해 드릴 수 있습니다.

만약 MS Entra ID를 사용하는 회사가 직원들이 다른 로그인 방법(Google, 네이버, 카카오 등)으로 로그인하지 못하도록 만들고 싶은 경우(반드시 MS 로그인만 강제)에는 다음의 URL을 사내 전파하시면 됩니다.


<https://wrks.ai/ko/signin/id/**우리회사영문이름**\\>
\
ex) <https://wrks.ai/ko/signin/id/ai3>


## 2. 그룹웨어로부터의 정보 제공을 통한 SSO

MS Entra ID를 사용하지 않고 **자체 그룹웨어 로그인**을 이용하고 있는 기업들도 웍스AI와의 자동 로그인을 구현하실 수 있습니다. 저희 [**기업사용자용 API 이용가이드**](https://bit.ly/wrks-orgapi) 18페이지 '**암호화 코드 기반 인증 프로세스**' 내용을 참고해 주세요.

<figure><img src="/files/E83OPwCKaigDLJzJE4dl" alt="" width="375"><figcaption></figcaption></figure>

**그룹웨어에서 웍스AI로 가는 링크**를 추가해 두시고, 임직원이 **해당 링크를 클릭**하게 되면 임직원의 **암호화된 인사정보**가 **웍스AI에 제공되어 인증**되는 방식입니다.

<figure><img src="/files/HjcGg0gkcoFA6NasjfYI" alt="" width="309"><figcaption></figcaption></figure>

이 방식을 사용하시는 경우, **최초 1회 임직원이 웍스AI에 접속**하게 되면 '**개인정보 제공 동의**' 창이 떠서 **임직원이 동의하는 경우에만** 자동 로그인이 이루어지게 됩니다. 위 [**API 이용가이드**](https://bit.ly/wrks-orgapi)를 참고하여 기업들이 직접 개발 연동해 주시면 됩니다. **API 키 발급**은 **<enterprise@wrks.ai>** 로 요청해 주시기 바랍니다.

## 3. 회사 이메일로 직접 가입/로그인

위 1번 방식은 MS Entra ID를 쓰고 있는 기업만 이용 가능하고, 위 2번 방식은 별도 개발이 필요하기 때문에 **많은 회사들은 이 3번 방식을 가장 많이 이용**하고 있습니다.

이 방식은 **모든 소속 임직원이 최초 1회 웍스AI 서비스에 회사 이메일로 직접 가입**해 주어야 하는 불편은 있지만 별도 개발이 필요없어 **가장 쉬운 연동 방식**입니다.

저희 **<enterprise@wrks.ai>** 메일로 사용하고 계시는 **회사 이메일 도메인 주소**(@company.com)를 알려주세요. 그러면 저희가 **회사 계정에 해당 도메인을 연결**해 드려요.

그 이후 **임직원들에게 공지**하시고 임직원들이 **웍스AI에 회사 이메일로 가입**하시면 자동으로 **회사 계정에 접속**돼 이용하실 수 있게 됩니다. 퇴사시 회사 이메일을 못쓰시게 되실 것이므로 이 방식은 앞서 다른 1,2번 방식과 동일하게 **입/퇴사자도 자연스럽게 관리 가능**한 방식입니다.

## 4. 임직원 일괄 초대 방식

100명 미만의 중소 규모 조직에 가장 적합한 방식입니다. 관리자가 서비스 우측 상단 **\[기업관리자]** 내 **\[사용자 관리]** 메뉴에서 파란색 '**사용자 신규 초대**' 버튼을 눌러 **임직원들을 직접 초대**하는 방식입니다.

사용자 신규 초대 창이 뜨면 두번째 탭 '**일괄 대량 초대**'를 눌러보세요. 여기서 '**초대 양식 다운로드**' 버튼을 누르시면 **임직원 초대 양식 CSV 파일**을 내려 받으실 수 있어요.

<figure><img src="/files/XQnljFiLDEIARcaGgpf0" alt="" width="563"><figcaption></figcaption></figure>

CSV 파일을 열어보면 아래와 같은 예제 내용이 보입니다. 이 내용(이순신, 강감찬, 권율)을 모두 지우고 **우리 회사에 초대할 사람들의 정보를 각 행으로 분리해 쭉 추가**해 주세요. 각 행마다 들어갈 정보는 **이름, 이메일, 권한** 세가지입니다.

<figure><img src="/files/YfSETkp0nnuXF4x6TNY5" alt=""><figcaption></figcaption></figure>

**대부분 사용자의 권한은 모두 '일반 사용자'**&#xB85C; 입력해 주시면 됩니다. 그 중 일부 관리자로 지정할 사용자만 '**최고 관리자**' 또는 '**워크스페이스 관리자**'로 입력해 주시면 됩니다.

이렇게 입력을 완료한 **CSV 파일을 저장**하신 후 위 '**일괄 대량 초대**' 탭에 **파일을 업로드** 해주시면 파일에 추가된 모든 사용자의 이메일로 웍스AI **우리 회사 환경으로의 초대 메일이 발송**됩니다. 그러면 초대 메일의 내용에 따라 **각자 가입**해 주시면 **회사 환경을 이용**할 수 있게 됩니다.