# 로그인 연동

웍스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을 사내 전파하시면 됩니다.

{% hint style="success" %}
<https://wrks.ai/ko/signin/id/**우리회사영문이름**\\>
\
ex) <https://wrks.ai/ko/signin/id/ai3>
{% endhint %}

## 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 **우리 회사 환경으로의 초대 메일이 발송**됩니다. 그러면 초대 메일의 내용에 따라 **각자 가입**해 주시면 **회사 환경을 이용**할 수 있게 됩니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wrks.ai/admin-guide/integrations/sso.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.