act 클레임으로 에이전트의 요청과 사용자의 요청을 구분합니다.
에이전트 액세스는 모든 요금제에 포함되며, 별도 요금은 없습니다.
작동 방식
- AI 에이전트가 필요한 스코프를 명시하며 애플리케이션 내에서 사용자를 대신해 작업을 요청합니다.
- 사용자는 애플리케이션의 호스팅 승인 화면 또는 귀사의 동의 화면에서 로그인하여 에이전트의 이름, 검증 여부, 요청하는 권한을 확인합니다.
- 사용자는 요청을 좁힐 수 있습니다(스코프 축소, 세션 기간 단축, 조직 일부만 선택). 그런 다음 설정에서 요구하는 경우 새 패스키로 인증한 뒤 승인합니다.
- 에이전트는 일회용 코드를 받고 이를 자체 토큰으로 교환합니다. 에이전트의 액세스 토큰은 사용자의 토큰과 마찬가지로 최대 5분간 유효합니다.
- 에이전트가 귀사의 백엔드에 보내는 모든 요청에는
act클레임에 에이전트와 사용자가 승인한 스코프가 명시된 토큰이 포함됩니다.
기능을 켜고 규칙 선택
에이전트 액세스는 새 애플리케이션에서 기본적으로 꺼져 있습니다. Authentication > Agent access에서 켠 다음 Edit settings를 선택하십시오.
사용자는 승인 화면에서 제공된 범위를 끌 수는 있지만, 켤 수는 없습니다.
변경 사항은 새 승인에만 적용되며, 활성 에이전트 세션은 사용자가 승인한 내용을 그대로 유지합니다.
Only people approve agent requests (
agent_humans_only) 설정은 Didit 조직의 Owner 또는 Admin만 변경할 수 있으며, 변경하려면 먼저 본인의 콘솔 계정에 패스키가 등록되어 있어야 합니다.
이 설정은 승인하는 사용자가 사용자 인증이 적용된 본인의 인증기를 사용했으며, 해당 사용이 5분 이내에 이루어지고 해당 요청과 연결되었음을 증명합니다. 다만 자동화 전반을 감지하지는 않습니다.
자체 동의 화면을 구현하려면 패스키로 에이전트 승인하기에서 호출 방법을 확인하십시오.
앱에 추가하기
지원하는 에이전트는 스스로 사용자를 승인 화면으로 안내합니다. 앱에서 해야 할 일은 두 가지입니다. 사용자가 자신의 에이전트를 확인하고 액세스 권한을 철회할 수 있게 하세요. React에서는 계정 설정 페이지에<ConnectedAgents />를 렌더링하세요. 이 컴포넌트는 사용자가 승인한 에이전트를 나열하며, 각 항목에 Revoke 버튼이 표시됩니다.
자세한 내용은 React 빠른 시작을 참조하세요.
백엔드에서 act 클레임을 확인하세요.
에이전트의 액세스 토큰은 사용자의 토큰과 같은 키로 서명되고 같은 typ, iss, aud 값을 가지므로, act만이 둘을 구별합니다.
에이전트 토큰의
sid는 사용자가 부여한 액세스의 ID입니다. GET /session/은 에이전트 토큰을 항상 거부합니다.
코드로 된 검사 방법은 서버에서 토큰 검증하기를 참조하세요.
콘솔에서 모니터링 및 해지
Authentication > Agent access에서 다음 내용을 볼 수 있습니다:- 한눈에 보기: 활성 에이전트 세션 수, 최근 7일 동안 사용자가 승인한 세션 수, 에이전트가 있는 사용자 수, 이번 달 해지 건수를 사용자별과 팀별로 확인할 수 있습니다.
- 활성 에이전트 세션: 각 사용자, 설명과 검증 여부가 포함된 에이전트, 에이전트가 수행할 수 있는 작업, 마지막 활동 시각, 세션 종료 시각을 보여주며, Revoke 버튼이 함께 표시됩니다.

Authentication > Agent access 화면.
이메일 및 이벤트
팀이 콘솔에서 에이전트의 액세스를 해지하면, 해당 사용자에게 해지 사실을 알리는 이메일을 보낼 수 있습니다. 이 이메일에는 다른 모든 로그인 이메일과 마찬가지로 귀사의 브랜드가 적용됩니다. 승인과 해지는 사용자의 타임라인에security.agent_access_approved 및 security.agent_access_revoked 이벤트로 기록됩니다. 에이전트가 코드를 한 번도 교환하지 않았더라도, 사용자가 동의하면 Didit은 승인을 기록합니다. 자세한 내용은 에이전트 승인 감사를 참조하십시오.