> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# AI 에이전트 접근 권한: 사용자의 AI 에이전트가 대신 작업하도록 허용

> Didit으로 사용자가 자신의 AI 에이전트에 앱 내 작업 권한을 승인하게 하세요. 범위가 제한된 세션은 자동으로 종료되며, 본인 또는 팀이 언제든 취소할 수 있습니다.

Didit Authentication의 에이전트 액세스를 사용하면 앱 사용자가 자신의 AI 에이전트를 승인해 대신 작업하도록 할 수 있습니다. 사용자는 에이전트가 요청하는 내용을 확인하고 승인합니다. 그러면 에이전트는 자체적으로 범위가 지정된 세션을 부여받고, 이 세션은 자동으로 종료되며 사용자 또는 귀사의 팀이 언제든지 취소할 수 있습니다. 백엔드는 토큰의 `act` 클레임으로 에이전트의 요청과 사용자의 요청을 구분합니다.

에이전트 액세스는 모든 요금제에 포함되며, 별도 요금은 없습니다.

## 작동 방식

1. AI 에이전트가 필요한 스코프를 명시하며 애플리케이션 내에서 사용자를 대신해 작업을 요청합니다.
2. 사용자는 애플리케이션의 호스팅 승인 화면 또는 귀사의 동의 화면에서 로그인하여 에이전트의 이름, 검증 여부, 요청하는 권한을 확인합니다.
3. 사용자는 요청을 좁힐 수 있습니다(스코프 축소, 세션 기간 단축, [조직](https://docs.didit.me/ko/authentication/organizations.md) 일부만 선택). 그런 다음 설정에서 요구하는 경우 새 패스키로 인증한 뒤 승인합니다.
4. 에이전트는 일회용 코드를 받고 이를 자체 토큰으로 교환합니다. 에이전트의 액세스 토큰은 사용자의 토큰과 마찬가지로 최대 5분간 유효합니다.
5. 에이전트가 귀사의 백엔드에 보내는 모든 요청에는 `act` 클레임에 에이전트와 사용자가 승인한 스코프가 명시된 토큰이 포함됩니다.

에이전트의 세션은 수명이 다하거나, 설정된 유휴 시간 제한이 지나거나, 사용자 또는 귀사의 팀이 세션을 취소하면 종료됩니다.

## 기능을 켜고 규칙 선택

에이전트 액세스는 새 애플리케이션에서 기본적으로 꺼져 있습니다.
**Authentication > Agent access**에서 켠 다음 **Edit settings**를 선택하십시오.

| 설정 | 옵션 | 기본값 |
| - | - | - |
| 에이전트가 할 수 있는 작업 | **Read only** (`read`): 사용자의 계정 정보를 조회합니다. **Acts for them** (`act`): 사용자의 계정 설정과 환경설정을 변경합니다. | 직접 선택하기 전까지 없음 |
| 요청할 수 있는 에이전트 | 현재는 모든 에이전트가 요청할 수 있으며, 승인 화면에 인증 여부가 표시됩니다. 인증된 에이전트만 허용하는 기능은 아직 제공되지 않습니다. | 모든 에이전트 |
| 세션 유지 기간 | 1일, 7일 또는 30일. | 7일 |
| 유휴 시 종료 시간 | 30분, 2시간 또는 24시간. | 2시간 |
| 승인 방식 | **A passkey** 또는 **Their usual sign-in**. | A passkey |
| 사람만 에이전트 요청을 승인 | 각 승인마다 승인하는 사용자 본인의 패스키에서 새로운 어설션이 필요합니다. | 꺼짐 |

사용자는 승인 화면에서 제공된 범위를 끌 수는 있지만, 켤 수는 없습니다.
변경 사항은 새 승인에만 적용되며, 활성 에이전트 세션은 사용자가 승인한 내용을 그대로 유지합니다.

**Only people approve agent requests** (`agent_humans_only`) 설정은 Didit 조직의 Owner 또는 Admin만 변경할 수 있으며, 변경하려면 먼저 본인의 콘솔 계정에 패스키가 등록되어 있어야 합니다.
이 설정은 승인하는 사용자가 사용자 인증이 적용된 본인의 인증기를 사용했으며, 해당 사용이 5분 이내에 이루어지고 해당 요청과 연결되었음을 증명합니다. 다만 자동화 전반을 감지하지는 않습니다.
자체 동의 화면을 구현하려면 [패스키로 에이전트 승인하기](https://docs.didit.me/ko/authentication/sign-in-methods.md#패스키를-사용한-에이전트-승인)에서 호출 방법을 확인하십시오.

## 앱에 추가하기

지원하는 에이전트는 스스로 사용자를 승인 화면으로 안내합니다.
앱에서 해야 할 일은 두 가지입니다.

**사용자가 자신의 에이전트를 확인하고 액세스 권한을 철회할 수 있게 하세요.**
React에서는 계정 설정 페이지에 `<ConnectedAgents />`를 렌더링하세요. 이 컴포넌트는 사용자가 승인한 에이전트를 나열하며, 각 항목에 **Revoke** 버튼이 표시됩니다.
자세한 내용은 [React 빠른 시작](https://docs.didit.me/ko/authentication/quickstarts/react.md)을 참조하세요.

**백엔드에서 `act` 클레임을 확인하세요.**
에이전트의 액세스 토큰은 사용자의 토큰과 같은 키로 서명되고 같은 `typ`, `iss`, `aud` 값을 가지므로, `act`만이 둘을 구별합니다.

| `act` | 호출자 | 허용 대상 |
| - | - | - |
| `null` | 사용자 본인입니다. | 사용자가 할 수 있는 작업입니다. |
| `{"sub", "agent", "scopes"}` | 사용자를 대신하는 AI 에이전트입니다. | 에이전트에 열어 둔 경로에서만, `act.scopes`가 부여한 범위 내의 작업만 허용하세요. 그 밖의 모든 곳에서는 거부하세요. |

에이전트 토큰의 `sid`는 사용자가 부여한 액세스의 ID입니다. `GET /session/`은 에이전트 토큰을 항상 거부합니다.
코드로 된 검사 방법은 [서버에서 토큰 검증하기](https://docs.didit.me/ko/authentication/tokens-and-jwks.md#서버에서-토큰-검증)를 참조하세요.

## 콘솔에서 모니터링 및 해지

**Authentication > Agent access**에서 다음 내용을 볼 수 있습니다:

* **한눈에 보기:** 활성 에이전트 세션 수, 최근 7일 동안 사용자가 승인한 세션 수, 에이전트가 있는 사용자 수, 이번 달 해지 건수를 사용자별과 팀별로 확인할 수 있습니다.
* **활성 에이전트 세션:** 각 사용자, 설명과 검증 여부가 포함된 에이전트, 에이전트가 수행할 수 있는 작업, 마지막 활동 시각, 세션 종료 시각을 보여주며, **Revoke** 버튼이 함께 표시됩니다.

![Didit Business Console의 에이전트 액세스 페이지로, 에이전트 설정, 주요 지표, 그리고 Revoke 버튼이 있는 활성 에이전트 세션이 표시되어 있습니다](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-agent-access.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=7cc518e37e2ccafa5515eb22e6ef9b8d)

Authentication > Agent access 화면.

해지하면 에이전트 세션이 즉시 종료되며, 해당 사용자에게 세션이 종료되었다는 이메일을 보낼 수 있습니다.
팀은 특정 사용자의 에이전트 세션을 모두 종료할 수도 있습니다. **Users**에서 사용자를 차단하거나, MFA를 재설정하거나, 세션을 해지하면 해당 사용자의 에이전트 액세스도 함께 해지됩니다.

## 이메일 및 이벤트

팀이 콘솔에서 에이전트의 액세스를 해지하면, 해당 사용자에게 해지 사실을 알리는 이메일을 보낼 수 있습니다. 이 이메일에는 다른 모든 [로그인 이메일](https://docs.didit.me/ko/authentication/branding-and-custom-domain.md#로그인-이메일)과 마찬가지로 귀사의 브랜드가 적용됩니다.

승인과 해지는 사용자의 타임라인에 `security.agent_access_approved` 및 `security.agent_access_revoked` 이벤트로 기록됩니다. 에이전트가 코드를 한 번도 교환하지 않았더라도, 사용자가 동의하면 Didit은 승인을 기록합니다. 자세한 내용은 [에이전트 승인 감사](https://docs.didit.me/ko/authentication/events-and-webhooks.md#에이전트-승인-감사)를 참조하십시오.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.