개요
MongoDB Atlas 앱 Connections를 사용하면 타사 애플리케이션이 사용자 위임 액세스를 통해 Atlas 사용자를 대신하여 작업을 수행할 수 있습니다. Organization Owner는 애플리케이션이 조직에 연결할 수 있는지 여부를 제어합니다.
이 페이지에서는 다음을 수행하는 방법에 대해 설명합니다.
조직에 대한 타사 앱 연결을 활성화하거나 비활성화합니다.
인증된 애플리케이션의 최대 새로 고침 토큰 수명을 설정합니다.
사용자가 승인한 애플리케이션을 확인합니다.
애플리케이션의 액세스를 비활성화할 때 사용자가 직접 정리해야 하는 작업이 무엇인지 확인하세요.
위임된 액세스 작동 방식
사용자가 애플리케이션을 승인하면 해당 애플리케이션은 사용자를 대신하여 작업을 수행합니다. 애플리케이션은 사용자가 Atlas 조직 및 프로젝트에서 보유한 동일한 권한으로 Atlas Administration API를 호출할 수 있는 토큰을 받습니다. 사용자가 조치를 수행할 수 없는 경우 애플리케이션도 사용자를 대신하여 조치를 수행할 수 없습니다.
사용자 본인의 권한에서 액세스 권한이 위임되기 때문에:
사용자의 역할이 변경되면 애플리케이션의 유효 권한이 자동으로 변경됩니다.
조직에 대한 작업은 조직이 타사 앱 연결을 허용 하고 승인하는 사용자에게 해당 작업에 필요한 역할이 있는 경우에만 성공합니다.
애플리케이션은 OAuth 2.1를 사용합니다. PKCE(Proof Key for Code Exchange)를 포함한 권한 부여 코드 흐름을 사용하여 위임된 액세스 권한을 얻습니다. 애플리케이션이 이 흐름과 통합되는 방법을 학습하려면 Atlas 앱 연결과 앱 통합을 참조하세요.
타사 앱 연결 활성화 또는 비활성화
타사 앱 연결이 기본적으로 활성화되어 있는지 여부는 조직이 생성된 시기에 따라 다릅니다.
기존 조직 및 Atlas App Connections가 출시되기 전에 생성된 조직은 타사 앱 연결이 기본값 비활성화되어 있습니다. Organization Owner가 이를 활성화해야 합니다.
Atlas App Connections가 출시된 후 Atlas에 등록할 때 사용자가 생성하는 새 조직은 타사 앱 연결이 기본적으로 활성화되어 있습니다. 이는 기존 조직에 가입하는 사용자에게는 적용되지 않습니다.
타사 앱 연결이 비활성화된 동안 애플리케이션이 획득한 위임된 액세스 토큰은 조직의 Atlas Administration API를 호출할 때 403 Forbidden 응답을 받습니다.
이전에 타사 앱 연결을 허용했던 조직에 대해 이를 비활성화하면 변경 사항이 즉시 적용됩니다. 사용자 위임을 통해 조직을 대상으로 하는 Atlas Administration API 호출은 403 Forbidden을(를) 반환하기 시작합니다.
타사 앱 연결을 비활성화하면 애플리케이션이 사용자 위임을 통해 제어 평면에 액세스하는 것이 중단됩니다. 애플리케이션이 이미 가지고 있을 수 있는 다른 액세스 권한은 취소 되지 않습니다.
데이터 플레인 액세스가 계속됩니다. 애플리케이션이 생성한 데이터베이스 사용자 및 연결 문자열은 계속 작동하므로 기존 MongoDB 드라이버 또는 연결 풀 세션은 활성 상태를 유지합니다.
기타 제어 평면 자격 증명은 계속됩니다. 애플리케이션이 서비스 계정이나 API 키를 생성한 경우, 이를 제거하기 전까지는 제어 평면 액세스 권한이 유지됩니다.
애플리케이션의 액세스 권한을 완전히 제거하려면 이러한 리소스를 직접 정리해야 합니다. 제한 사항 및 책임을 참조하세요.
타사 앱 연결을 허용하거나 제한하려면 다음 단계를 완료하세요.
Third-Party Apps 섹션에는 조직에 연결할 수 있는 애플리케이션이 나열됩니다. 각 애플리케이션은 현재 설정을 반영하는 ALLOWED 또는 RESTRICTED 배지를 표시합니다. 연결이 허용되면 View connections 버튼을 통해 사용자가 승인한 애플리케이션으로 이동할 수 있습니다.
이 설정은 타사 애플리케이션에 대한 액세스를 제어합니다. Remote MCP Server를 통한 액세스를 제어하는 별도의 설정에 대해 학습하려면 조직에 대한 AI 클라이언트 액세스 관리를 참조하세요.
최대 새로 고침 토큰 수명 설정
인증된 애플리케이션은 refresh token을 사용하여 사용자에게 다시 인증하도록 요청하지 않고 새 액세스 토큰을 얻습니다. Organization Owner는 조직에서 승인된 애플리케이션에 대해 최대 새로 고침 토큰 유효 기간을 설정할 수 있습니다.
리프레시 토큰에는 두 가지 제한이 적용됩니다.
최대 유효 기간은 리프레시 토큰이 유효하게 유지될 수 있는 가장 긴 기간입니다. 토큰이 이 한도에 도달하면 사용자는 활동 여부와 관계없이 애플리케이션을 다시 인증해야 합니다. 기본값은 30 일입니다.
유휴 수명은 새로 고침 토큰이 사용되지 않고 유효한 상태로 유지되는 기간입니다. 이 기간 내에 사용되지 않은 토큰은 만료됩니다. 기본값은 7 일입니다. 유휴 수명은 최대 수명을 초과할 수 없습니다.
Atlas UI에서 Organization Owner는 최대 수명을 조정할 수 있습니다. 유휴 수명은 Atlas UI가 아닌 Atlas Administration API를 통해서만 사용자 지정할 수 있습니다.
참고
기본값 수명은 OAuth 클라이언트별로 구성되므로 적용되는 기본값은 연결하는 클라이언트에 따라 다릅니다.
최대 리프레시 토큰 수명을 설정하려면 다음 단계를 완료하세요.
저장하면 섹션에 현재 최대 수명이 표시됩니다. 값을 변경하려면 편집 아이콘을 클릭하세요.
타사 앱 연결을 허용하거나 제한하는 설정과 달리, 최대 새로 고침 토큰 수명은 조직 전체에 적용되는 단일 설정입니다. 이 설정은 Remote MCP Server를 통해 연결하는 클라이언트를 포함하여 조직의 모든 앱 연결에 적용됩니다. 해당 클라이언트에 대해 자세히 알아보려면 조직에 대한 AI 클라이언트 액세스 관리를 참조하세요.
최대 새로 고침 토큰 수명 지우기
조직에 설정한 최대 새로 고침 토큰 수명을 제거하려면 현재 값 다음의 삭제 아이콘을 클릭하세요. 그리고 Clear을 클릭하여 확인합니다. 설정을 해제하면 각 클라이언트에 대한 유효 수명이 기본값으로 돌아각니다.
승인된 애플리케이션 보기
조직의 사용자가 승인한 타사 애플리케이션을 각 연결에 대한 메타데이터와 함께 검토할 수 있습니다.
애플리케이션의 연결 페이지에는 다음 세부 정보와 함께 연결된 각 노드가 나열됩니다.
Users: 애플리케이션을 승인한 Atlas user입니다.
Last used: 애플리케이션이 가장 최근에 해당 사용자를 대신하여 작업을 수행했을 때입니다.
Last authorized: 사용자가 가장 최근에 애플리케이션을 승인한 시점입니다.
제한 사항 및 책임
중요
애플리케이션의 액세스를 비활성화해도 애플리케이션이 생성한 리소스는 제거되지 않습니다. Atlas는 액세스를 비활성화할 때 데이터베이스 사용자, 서비스 계정, API 키 또는 기타 리소스를 자동으로 삭제하지 않습니다. 이러한 리소스를 정리하는 것은 사용자의 책임입니다. 제거하기 전까지 이러한 자격 증명은 Atlas 계정에서 활성 상태로 유지되며 데이터 평면 또는 제어 평면 액세스 권한을 유지할 수 있습니다.
애플리케이션의 액세스를 비활성화할 때는 다음 사항에 유의하세요.
Atlas는 애플리케이션이 사용자를 대신하여 생성한 데이터베이스 사용자를 자동으로 삭제하지 않습니다. 이러한 데이터베이스 사용자와 해당 연결 문자열은 액세스를 비활성화한 후에도 계속 작동합니다.
Atlas는 애플리케이션이 생성한 서비스 계정이나 API 키를 자동으로 삭제 하지 않습니다. 이러한 자격 증명은 사용자가 제거할 때까지 제어 평면 액세스 권한을 유지합니다.
Atlas는 클러스터나 프로젝트와 같이 애플리케이션이 생성한 다른 리소스를 자동으로 삭제하지 않습니다.
기존 데이터 평면 연결은 정상적인 연결 수명 주기 이벤트가 발생하여 종료될 때까지 활성 상태로 유지됩니다.
애플리케이션을 완전히 오프보딩하려면 오프보딩 권장사항을 참조하세요.
오프보딩 권장사항
애플리케이션 사용을 중단할 때 액세스를 비활성화하는 것은 첫 번째 단계일 뿐입니다. 애플리케이션을 완전히 오프보딩하고 데이터를 보호하려면 다음 정리 작업을 완료하세요.
다른 애플리케이션이나 워크로드가 해당 사용자에 종속되지 않는 경우, 애플리케이션이 사용자를 대신하여 생성한 데이터베이스 사용자를 삭제합니다.
데이터베이스 사용자를 삭제하기 전에 해당 연결 문자열이 여전히 액세스가 필요한 다른 애플리케이션이나 워크로드에서 공유되지 않는지 확인하십시오.
애플리케이션이 생성한 서비스 계정이나 API 키를 삭제하세요. 그렇지 않으면 제어 평면에 대한 액세스 권한이 유지됩니다.
애플리케이션이 프로비저닝한 클러스터, 프로젝트 또는 기타 리소스 중 더 이상 필요하지 않은 항목을 검토하고 제거하세요.