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

# 키·연결 관리

> 조직 API Key, 워크스페이스 API Key, OAuth 앱을 누가 만들고 어디서 관리하는지, 노출이 의심될 때 무엇을 하는지 조직 관리자에게 안내해요.

엔터프라이즈 엔터프라이즈 조직 관리자를 위한 안내예요.

티로 외부 연동에 쓰는 키와 앱은 [Tiro Platform](https://platform.tiro.ooo)에서 관리해요. API Key는 화면 위쪽 **\[관리할 곳]** 에서 계정·워크스페이스·조직을 골라 관리해요. OAuth 앱은 조직을 선택한 뒤 **\[OAuth 앱]** 에서 관리해요.

## 누가 무엇을 만들고 관리하나요?

| 항목 | 만들고 관리하는 사람 | 어디서 |
| - | - | - |
| 조직 API Key | 조직 Admin·Developer | **\[관리할 곳]** 에서 조직 선택 → **\[API Key]** |
| 워크스페이스 API Key | 워크스페이스 관리자 | **\[관리할 곳]** 에서 워크스페이스 선택 → **\[API Key]** |
| 계정 API Key | 구성원 본인 | **\[관리할 곳]** 에서 내 계정 선택 → **\[API Key]** |
| OAuth 앱 | 조직 Admin·Developer | **\[관리할 곳]** 에서 조직 선택 → **\[OAuth 앱]** |
| AI 앱(MCP) 연결 | 구성원 본인 | 구성원이 쓰는 AI 앱의 연결 설정 |

각 키가 볼 수 있는 노트는 [외부 앱이 볼 수 있는 데이터](https://docs.tiro.ooo/ko/enterprise/data-access.md)에 정리돼 있어요.

## 조직 API Key를 만들 때 무엇을 정하나요?

**\[API Key 만들기]** 에서 아래 항목을 정해요. 키 값은 만든 직후 한 번만 보여주니 바로 안전한 곳에 저장하세요.

* **\[권한]**: **\[모든 권한]** 또는 **\[선택한 권한만]**. 연동에 필요한 권한만 고르세요. **\[모든 권한]** 도 키 종류에 따른 노트 범위 제한은 그대로예요.
* **\[접근할 워크스페이스]**: **\[현재와 앞으로 추가할 모든 워크스페이스]** 또는 **\[선택한 워크스페이스만]**.
* **\[만료 기한]**: 연동 기간이 정해져 있으면 기한을 두세요.
* **\[허용 호스트]**: 키를 쓸 수 있는 호스트를 제한해요. 조직 전체에 공통으로 적용할 호스트는 [조직 보안 설정](https://docs.tiro.ooo/ko/guide/privacy/enterprise-security.md)의 **\[API Key 허용 호스트]** 에서 관리해요.

## OAuth 앱은 어떻게 관리하나요?

OAuth 앱은 사내 시스템이 구성원의 동의를 받아 그 구성원의 노트를 조회할 때 써요. 등록 절차는 개발자 문서의 [OAuth 앱 연동](https://docs.tiro.ooo/ko/developers/fundamentals/oauth.md)에 있어요. 등록한 앱은 목록에서 상태를 바꿀 수 있어요.

* **\[신규 승인 중단]**: 새로운 승인 요청을 막아요. 이미 발급된 토큰으로 맺은 연결은 유지돼요. 다만 이전에 승인한 구성원도 다시 연결하려면 신규 승인을 재개해야 해요.
* **\[Secret 재발급]**: 기존 Client Secret을 바로 쓸 수 없게 하고 새 값을 받아요. 앱을 쓰는 서버 설정을 바꿀 준비를 하고 진행하세요.

## 키가 노출된 것 같으면 어떻게 하나요?

노출이 의심되는 키는 바로 삭제하고 새 키를 만들어 연동에 넣으세요. 키를 삭제하면 그 키를 쓰는 연동이 멈추고, 삭제는 되돌릴 수 없어요. OAuth 앱의 Client Secret이 노출됐다면 **\[Secret 재발급]** 으로 바꾸세요.

## SSO·SCIM은 어디서 설정하나요?

SSO와 SCIM은 사내 인증 체계와 맞물려 있어서 도입 과정에서 담당 매니저와 함께 구성해요. 준비할 항목은 [조직 관리자 가이드](https://docs.tiro.ooo/ko/enterprise/org-admin.md#도입-과정에서-함께-설정하는-것)에 있어요.

***

**관련 페이지**: [외부 앱이 볼 수 있는 데이터](https://docs.tiro.ooo/ko/enterprise/data-access.md) · [조직 관리자 가이드](https://docs.tiro.ooo/ko/enterprise/org-admin.md) · [조직 보안 설정](https://docs.tiro.ooo/ko/guide/privacy/enterprise-security.md)


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