OAuth 설정 관리
OAuth 설정은 Braze MCP 서버에 대한 회사 전체 액세스를 관리하고, 커스텀 MCP 클라이언트 리디렉트 URI가 Braze에 연결할 수 있는지를 제어하며, 회사의 모든 MCP OAuth 토큰을 취소할 수 있도록 합니다.
OAuth 설정은 전체 회사에 적용됩니다. 각 사용자에게 할당된 권한에 따라 MCP 서버를 통해 액세스할 수 있는 워크스페이스와 기능이 결정됩니다.
요구 사항
| 요구 사항 | 설명 |
|---|---|
| “Admin” 권한 | OAuth 설정을 보거나, MCP OAuth 액세스를 켜거나 끄거나, 리다이렉트 URI를 관리하거나, MCP OAuth 토큰을 취소하려면 회사 수준의 “Admin” 권한이 있어야 합니다. |
| “Use MCP Server” 권한 | 사용자가 MCP 서버를 통해 액세스하려는 각 워크스페이스에 대해 이 권한이 필요합니다. 이 권한은 OAuth 설정을 관리하는 데 사용되는 “Admin” 권한과는 별개입니다. |
권한 할당에 대한 자세한 내용은 사용자 권한을 참조하세요.
OAuth 액세스 작동 방식
OAuth 설정과 사용자 권한은 함께 작동합니다:
- 회사 전체 OAuth 설정은 사용자가 MCP 클라이언트를 Braze에 연결할 수 있는지 여부를 결정합니다.
- “Use MCP Server” 권한은 개별 사용자가 워크스페이스에서 MCP 서버를 사용할 수 있는지 여부를 결정합니다.
- 사용자의 기존 대시보드 권한은 MCP 클라이언트가 액세스할 수 있는 Braze 데이터 및 기능을 결정합니다.
- 하나의 OAuth 연결은 사용자가 액세스 권한을 가진 워크스페이스에만 액세스할 수 있습니다.
MCP OAuth 액세스를 활성화해도 사용자에게 새로운 워크스페이스 권한이 부여되지 않습니다. 마찬가지로, 대시보드 권한을 제거하면 해당 사용자의 연결된 MCP 클라이언트에서도 해당 기능이 제거됩니다.
회사 및 워크스페이스 제어
OAuth 정책은 회사 수준에서 저장됩니다. 워크스페이스 관리자는 단일 워크스페이스에 대해 MCP OAuth 액세스 또는 리디렉트 URI 상태를 재정의할 수 없습니다.
| 제어 항목 | 설정 위치 | 범위 |
|---|---|---|
| MCP OAuth 액세스 | 설정 > 관리자 설정 > OAuth | 전체 회사. 이 설정이 꺼져 있으면 모든 워크스페이스에서 MCP OAuth가 거부됩니다. |
| 승인된 리디렉트 URI | 설정 > 관리자 설정 > OAuth | 전체 회사. 승인 및 차단된 URI는 모든 워크스페이스에 적용됩니다. |
| MCP OAuth 토큰 해지 | 설정 > 관리자 설정 > OAuth | 전체 회사. 해지는 모든 워크스페이스의 모든 MCP OAuth 토큰에 적용됩니다. |
| “Use MCP Server” 권한 | 설정 > 사용자 관리 | 워크스페이스별. 사용자는 MCP 서버를 통해 접근하는 각 워크스페이스에서 이 권한이 필요합니다. |
“Admin” 권한이 있는 사용자만 MCP OAuth 액세스를 변경하거나, 리디렉트 URI 상태를 변경하거나, MCP OAuth 토큰을 해지할 수 있습니다. 워크스페이스 권한이 이러한 회사 설정과 어떻게 상호작용하는지에 대해서는 OAuth 및 MCP 액세스를 참조하세요.
MCP OAuth 접근 켜기 또는 끄기
회사의 MCP OAuth 접근을 업데이트하려면:
- 설정 > 관리자 설정 > OAuth로 이동합니다.
- 전역 접근 제어에서 MCP OAuth 접근을 켜거나 끕니다.
MCP OAuth 접근이 켜져 있으면, “MCP 서버 사용” 권한이 있는 사용자가 승인된 MCP 클라이언트를 인증할 수 있습니다. 꺼져 있으면, 회사 내 모든 사용자와 워크스페이스에 대해 MCP 서버로의 OAuth 접근이 거부됩니다.
MCP OAuth 접근을 끄더라도 구성된 리디렉트 URI가 제거되거나 차단되지는 않습니다. Braze는 회사의 기존 MCP OAuth 토큰을 취소하므로, 연결된 MCP 클라이언트는 접근 권한을 잃게 됩니다. MCP OAuth 접근이 꺼져 있는 동안에는 승인된 리디렉트 URI 섹션이 숨겨지며, 동일한 URI 목록을 다시 관리하려면 다시 켜면 됩니다.
Braze가 사용자 환경에서 원격 MCP 서버를 꺼 놓은 경우, MCP OAuth 접근 토글이 비활성화되며 원격 MCP 서버가 다시 켜질 때까지 회사 설정이 효력이 없다는 메시지가 표시됩니다.
승인된 리디렉션 URI 관리
MCP OAuth 액세스를 켠 후, 승인된 리디렉션 URI 섹션에 커스텀 MCP 클라이언트가 인증 시 사용할 수 있는 리디렉션 URI 목록이 표시됩니다. 형식 안내는 리디렉션 URI 형식을 참조하세요.
승인된 리디렉션 URI 테이블에는 다음 정보가 표시됩니다.
| 열 | 설명 |
|---|---|
| 리디렉션 URI | Braze가 클라이언트의 콜백과 대조하는 정확한 주소(경로 포함)입니다. |
| 추가한 사용자 | URI를 추가하거나 마지막으로 업데이트한 대시보드 사용자입니다. |
| 추가된 날짜 | URI가 추가되거나 마지막으로 업데이트된 날짜입니다. |
| 상태 | URI가 Approved 또는 Blocked 상태인지 여부입니다. |
| 작업 | 현재 상태에 따라 Block 또는 Unblock입니다. |
리디렉션 URI 형식
| URI 유형 | 추가 시 사용할 형식 |
|---|---|
| 로컬(루프백 주소) | http://localhost 또는 http://127.0.0.1로 시작합니다. 포트(호스트 뒤의 콜론과 숫자)는 생략하여 모든 로컬 포트가 일치할 수 있도록 합니다. 예를 들어, 클라이언트가 http://localhost:33491/oauth/callback을 표시하면 http://localhost/oauth/callback을 입력합니다. 추가하는 URI에 포트(예: :33491)를 포함하면 Braze는 해당 포트만 일치시킵니다. |
| 원격 주소 | 클라이언트에 표시된 전체 주소를 그대로 입력합니다(예: https://app.example.com/callback). |
| 커스텀 스킴 | http:// 또는 https://가 아닌 커스텀 URI 스킴(예: cursor://)으로 시작합니다. 표시된 대로 정확히 입력합니다. 일부 데스크톱 앱이 이러한 주소를 사용합니다. |
리디렉션 URI 추가
아직 목록에 없는 커스텀 MCP 클라이언트를 허용하려면:
- Add redirect URI를 선택합니다.
- 클라이언트의 OAuth 또는 통합 설정에서 콜백 프로토콜이 포함된 전체 리디렉션 URI를 입력합니다. 클라이언트의 콜백과 일치시키는 데 도움이 필요하면 리디렉션 URI 형식 테이블을 참조하세요.
- Save를 선택합니다.
로컬 클라이언트의 경우 추가하는 리디렉션 URI에 127.0.0.1을 사용하고 포트 번호를 생략합니다.
Approved 상태의 리디렉션 URI만 새 OAuth 인증을 완료할 수 있습니다. URI가 목록에 없고 Braze 인증 클라이언트가 아닌 경우 Braze는 인증 요청을 거부합니다.
리디렉션 URI 차단
리디렉션 URI에서 새 OAuth 인증을 방지하려면 해당 행에서 Block을 선택하고 작업을 확인합니다. Braze는 URI 레코드를 유지하고 상태를 Blocked로 변경합니다.
리디렉션 URI를 차단해도 이미 해당 MCP 클라이언트에 연결된 사용자의 토큰은 해지되지 않습니다. 해당 세션을 종료하려면 Revoke MCP OAuth tokens를 선택합니다. URI 차단은 해당 콜백을 통한 새 인증을 방지하는 별도의 작업입니다.
또는, 사용자에게서 “Use MCP Server” 권한을 제거하여 해당 사용자만 MCP 서버를 사용하지 못하도록 할 수 있습니다. 다른 사용자의 MCP 연결은 Revoke MCP OAuth tokens를 선택할 때까지 활성 상태로 유지됩니다.
리디렉션 URI 차단 해제
차단된 리디렉션 URI의 액세스를 복원하려면 해당 행에서 Unblock을 선택하고 작업을 확인합니다. Braze는 중복을 생성하지 않고 기존 레코드를 Approved로 업데이트합니다.
이전에 해당 MCP 클라이언트에 연결되었던 사용자는 다시 인증해야 합니다.
MCP OAuth 토큰 취소
토큰을 취소하면 회사 전체의 모든 MCP OAuth 토큰이 한꺼번에 무효화됩니다. 토큰이 유출되었거나 오용된 것으로 의심되는 경우 이 기능을 사용하세요.
회사의 MCP OAuth 토큰을 취소하려면:
- 설정 > 관리자 설정 > OAuth로 이동합니다.
- MCP OAuth 토큰 취소에서 MCP OAuth 토큰 취소를 선택합니다.
- 확인 대화 상자를 검토한 다음 토큰 취소를 선택합니다.
Braze는 백그라운드에서 토큰을 취소하며, 취소가 완료되면 확인 메시지를 표시합니다. 연결이 많은 회사의 경우 몇 분 정도 걸릴 수 있습니다. 확인 메시지가 나타날 때까지 OAuth 페이지를 열어 두세요.
토큰 취소는 되돌릴 수 없습니다. 연결된 모든 MCP 클라이언트가 Braze에 대한 액세스를 잃으며, 각 사용자가 다시 로그인하여 MCP 클라이언트를 다시 연결해야 합니다.
취소 시 변경되는 사항
| 항목 | 결과 |
|---|---|
| 액세스 토큰 | 취소됩니다. 연결된 MCP 클라이언트는 사용자가 다시 연결할 때까지 작동하지 않습니다. |
| 리프레시 토큰 | 취소됩니다. MCP 클라이언트는 백그라운드에서 자체적으로 다시 연결할 수 없습니다. 사용자가 직접 다시 연결해야 합니다. |
| MCP OAuth 액세스 | 변경되지 않습니다. 활성화되어 있었다면 사용자가 즉시 다시 연결할 수 있습니다. |
| 승인된 리디렉트 URI | 변경되지 않습니다. 승인 및 차단된 URI는 그대로 유지됩니다. |
| “Use MCP Server” 권한 | 변경되지 않습니다. 사용자는 권한을 유지하며 다시 연결할 수 있습니다. |
| 새 연결 | 영향을 받지 않습니다. 취소를 시작한 이후에 생성된 연결은 계속 작동합니다. |
토큰을 취소할 때 이미 진행 중이던 요청은 회수되지 않습니다. 현재 세션만 종료하는 것이 아니라 모든 MCP 액세스를 중지하려면 MCP OAuth 액세스를 끄세요(이렇게 하면 MCP OAuth 토큰도 함께 취소됩니다). 특정 사용자의 MCP 액세스를 제거하려면 해당 사용자에게서 “Use MCP Server” 권한을 제거하세요.
취소가 완료되지 않으면 Braze에서 오류 메시지를 표시합니다. 일부 토큰이 이미 취소되었을 수 있으므로, 다시 시도하기 전에 지원팀에 문의하세요.
OAuth 활동 감사
Braze는 MCP 서버에 대한 OAuth 연결을 보안 이벤트 보고서에 기록합니다. 이 보고서를 사용하여 사용자가 OAuth를 통해 연결한 시점을 감사할 수 있습니다.
한 사용자의 MCP 접근 권한을 취소하려면 해당 사용자에게서 “Use MCP Server” 권한을 제거하세요. 회사 내 모든 MCP OAuth 토큰을 취소하려면 MCP OAuth 토큰 취소를 참조하세요. 설정 및 문제 해결 안내는 Braze MCP 서버 설정을 참조하세요.