- 제품 소개
- 구매 가이드
- 다운로드 센터
- 시나리오 솔루션
- 클라이언트 APIs
- 서버 APIs
- Generating UserSig
- RESTful APIs
- RESTful API Overview
- RESTful API List
- Message Related
- Session Related
- Group Related
- Group Management
- Group Information
- Group Member Management
- Group Member Information
- Group Custom Attributes
- Live Group Management
- Setting Live Streaming Group Robots
- Deleting Live Streaming Group Robots
- Setting/Deleting Live Streaming Group Administrators
- Obtaining the List of Live Streaming Group Administrators
- Checking Whether Users Are in a Live Streaming Group
- Getting the Number of Online Users in an Audio-Video Group
- Getting the List of Online Members in Audio-Video Group
- Setting Audio-Video Group Member Marks
- Getting the List of Banned Group Members
- Community Management
- Creating Topic
- Deleting Topic
- Getting Topic Profile
- Modifying Topic Profile
- Importing Topic Profiles
- Permission Group Management
- Creating Permission Groups
- Terminating Permission Groups
- Modifying Permission Group Information
- Obtaining Permission Group Information
- Adding Topic Permissions
- Modifying Topic Permissions
- Deleting Topic Permissions
- Obtaining Topic Permissions
- Adding Members to a Permission Group
- Deleting Permission Group Members
- Obtaining Permission Group Member List
- Group Counter
- User Management
- Global Mute Management
- Operations Management
- Chatbots
- Official Account Management
- Webhooks
- Webhook Overview
- Webhook Command List
- Operations Management Callbacks
- Online Status Webhooks
- Relationship Chain Webhooks
- One-to-One Message Webhooks
- Group Webhooks
- 그룹 생성 전 콜백
- After a Group Is Created
- Before Applying to Join a Group
- Before Inviting a User to a Group
- After a User Joins a Group
- After a User Leaves a Group
- 그룹 내 발언 전 콜백
- 그룹 내 발언 후 콜백
- 그룹 만원 후 콜백
- After a Group Is Disbanded
- 그룹 정보 변경 후 콜백
- 그룹 메시지 회수 후 콜백
- Webhook for Online and Offline Status of Audio-Video Group Members
- Webhook for Exceptions When Group Messages Are Sent
- 토픽 생성 전 콜백
- 토픽 생성 후 콜백
- 토픽 해산 후 콜백
- 토픽 프로필 수정 후 콜백
- Callback After Group Member Profile Changed
- Callback After Group Attribute Changed
- Callback After Read Receipt
- Callback After the Group Owner Changed
- Webhooks related to the Official Account
- Before a Official Account Is Created
- After a Official Account Is Created
- After Official Account Profile Is Modified
- After Official Account Is Destroyed
- Before Official Account Is Subscribed
- After Official Account Is Subscribed
- After a Official Account Is Full
- After Official Account Is Unsubscribed
- Before Official Account Message Is Sent
- Callback After Sending an Official Account Message
- Webhook After Recalling Official Account Messages
- 콘솔 가이드
- FAQ
- 협약 및 인증
- IM 정책
- 에러 코드
- 문의하기
- 제품 소개
- 구매 가이드
- 다운로드 센터
- 시나리오 솔루션
- 클라이언트 APIs
- 서버 APIs
- Generating UserSig
- RESTful APIs
- RESTful API Overview
- RESTful API List
- Message Related
- Session Related
- Group Related
- Group Management
- Group Information
- Group Member Management
- Group Member Information
- Group Custom Attributes
- Live Group Management
- Setting Live Streaming Group Robots
- Deleting Live Streaming Group Robots
- Setting/Deleting Live Streaming Group Administrators
- Obtaining the List of Live Streaming Group Administrators
- Checking Whether Users Are in a Live Streaming Group
- Getting the Number of Online Users in an Audio-Video Group
- Getting the List of Online Members in Audio-Video Group
- Setting Audio-Video Group Member Marks
- Getting the List of Banned Group Members
- Community Management
- Creating Topic
- Deleting Topic
- Getting Topic Profile
- Modifying Topic Profile
- Importing Topic Profiles
- Permission Group Management
- Creating Permission Groups
- Terminating Permission Groups
- Modifying Permission Group Information
- Obtaining Permission Group Information
- Adding Topic Permissions
- Modifying Topic Permissions
- Deleting Topic Permissions
- Obtaining Topic Permissions
- Adding Members to a Permission Group
- Deleting Permission Group Members
- Obtaining Permission Group Member List
- Group Counter
- User Management
- Global Mute Management
- Operations Management
- Chatbots
- Official Account Management
- Webhooks
- Webhook Overview
- Webhook Command List
- Operations Management Callbacks
- Online Status Webhooks
- Relationship Chain Webhooks
- One-to-One Message Webhooks
- Group Webhooks
- 그룹 생성 전 콜백
- After a Group Is Created
- Before Applying to Join a Group
- Before Inviting a User to a Group
- After a User Joins a Group
- After a User Leaves a Group
- 그룹 내 발언 전 콜백
- 그룹 내 발언 후 콜백
- 그룹 만원 후 콜백
- After a Group Is Disbanded
- 그룹 정보 변경 후 콜백
- 그룹 메시지 회수 후 콜백
- Webhook for Online and Offline Status of Audio-Video Group Members
- Webhook for Exceptions When Group Messages Are Sent
- 토픽 생성 전 콜백
- 토픽 생성 후 콜백
- 토픽 해산 후 콜백
- 토픽 프로필 수정 후 콜백
- Callback After Group Member Profile Changed
- Callback After Group Attribute Changed
- Callback After Read Receipt
- Callback After the Group Owner Changed
- Webhooks related to the Official Account
- Before a Official Account Is Created
- After a Official Account Is Created
- After Official Account Profile Is Modified
- After Official Account Is Destroyed
- Before Official Account Is Subscribed
- After Official Account Is Subscribed
- After a Official Account Is Full
- After Official Account Is Unsubscribed
- Before Official Account Message Is Sent
- Callback After Sending an Official Account Message
- Webhook After Recalling Official Account Messages
- 콘솔 가이드
- FAQ
- 협약 및 인증
- IM 정책
- 에러 코드
- 문의하기
주의：
IM CAM에서 사전 설정 정책을 사용하여 권한을 부여하는 것은 편리하지만, 권한 제어 단위가 비교적 커서 IM 애플리케이션 및 Tencent Cloud API까지 세분화되어있지 않습니다. 개발자가 더 세분화된 권한 제어 기능을 필요로 하는 경우, 사용자 정의 정책을 생성해야 합니다.
사용자 정의 정책 생성 방법
사용자 정의 정책 생성은 여러 가지 방법이 있으며, 하기 표는 여러 방법들의 비교표입니다. 구체적인 작업 프로세스는 다음을 참고하십시오.
게이트 | 방법 | 효과(Effect) | 리소스(Resource) | 작업(Action) | 유연성 | 난이도 |
정책 생성기 | 수동 선택 | 구문 기술 | 수동 선택 | 중간 | 중간 | |
정책 구문 | 구문 기술 | 구문 기술 | 구문 기술 | 높음 | 높음 | |
CAM 서버 API | 구문 기술 | 구문 기술 | 구문 기술 | 높음 | 높음 |
설명：
IM은 제품 기능별 또는 프로젝트별 사용자 정의 정책 생성을 지원하지 않습니다.
__수동 선택__은 사용자가 콘솔에 표시된 후보 목록에서 객체를 선택함을 의미합니다.
__구문 기술__은 권한 부여 정책 구문을 통해 객체를 기술하는 것을 의미합니다.
권한 부여 정책 구문
리소스 구문 기술
상기와 같이, IM 권한 관리의 리소스 세분성은 애플리케이션입니다. 애플리케이션의 정책 구문의 기술 방법은 CAM 리소스 기술 방법을 따릅니다. 하기 예시 중, 개발자의 루트 계정 ID는 12345678이고 개발자는 SDKAppID가 1400000000, 1400000001, 1400000002인 세 가지 애플리케이션을 생성합니다.
모든 IM 애플리케이션의 정책 구문 기술
"resource": ["qcs::im::uin/12345678:sdkappid/*"]
단일 애플리케이션의 정책 구문 기술
"resource": ["qcs::im::uin/12345678:sdkappid/1400000001"]
다수 애플리케이션의 정책 구문 기술
"resource": ["qcs::im::uin/12345678:sdkappid/1400000000","qcs::im::uin/12345678:sdkappid/1400000001"]
작업 구문 기술
상기와 같이, TRTC 권한 관리 작업 세분성은 Tencent Cloud API입니다. 하기 예시에서는 'DescribeAppStatList'(애플리케이션 목록 가져오기) 및 'DescribeSdkAppInfo'(애플리케이션 정보 가져오기) 등 Tencent Cloud API를 예로 듭니다.
IM 모든 Tencent Cloud API 정책 구문 기술
"action": ["name/im:*"]
단일 Tencent Cloud API 작업의 정책 구문 기술
"action": ["name/im:DescribeAppStatList"]
다수 Tencent Cloud API 작업의 정책 구문 기술
"action": ["name/im:DescribeAppStatList","name/im:DescribeTrtcAppAndAccountInfo"]
사용자 정의 정책 사용 예시
정책 생성기 사용
다음 예시 중에서는 사용자 정의 정책을 생성합니다. 해당 정책은 IM 애플리케이션인 1400000001에 대해 모든 작업을 허용합니다.
2. 정책 생성기로 생성을 선택하여 정책 생성 페이지로 이동합니다.
3. 서비스 및 작업을 선택합니다.
-효과(Effect) 설정 항목에서 허용을 선택합니다.
-서비스(Service) 설정 항목에서 IM을 선택합니다.
-작업(Action) 설정 항목에서 모든 항목을 선택합니다.
-리소스(Resource) 설정 항목은 리소스 구문 기술 설명에 따라
qcs::im::uin/12345678:sdkappid/1400000001을 기입합니다.
-조건(Condition) 설정 항목은 설정할 필요가 없습니다.성명문 추가를 클릭하면 페이지 하단에 ‘IM 애플리케이션 1400000001에 모든 작업 허용’ 문구가 나타납니다.
4. 같은 페이지에 다른 성명문을 계속 추가합니다.
-효과(Effect) 설정 항목에서 거부를 선택합니다.
-서비스(Service) 설정 항목에서 IM을 선택합니다.
-작업(Action) 설정 항목에서
RemoveUser를 선택합니다(검색 기능을 통해 빠른 찾기 가능).
-리소스(Resource) 설정 항목은 리소스 구문 기술 설명에 따라 qcs::im::uin/12345678:sdkappid/1400000001을 기입합니다.
-조건(Condition) 설정 항목은 설정할 필요가 없습니다.성명문 추가를 클릭하면 페이지 하단에 ‘IM 애플리케이션 1400000001에
RemoveUser 작업 금지’ 문구가 나타납니다.5. 다음을 클릭하고 필요에 따라 정책 이름을 수정합니다(또는 수정하지 않음).
6. 완료를 클릭하여 사용자 정의 정책 생성을 완료합니다.
정책 구문 사용
하기 예시에서는 1400000001 및 1400000002 IM 애플리케이션에 대해 모든 작업을 허용하는 사용자 정의 정책을 생성합니다.
2. 정책 구문으로 생성을 선택하여 정책 생성 페이지로 이동합니다.
3. 템플릿 유형 선택 상자에서 빈 템플릿을 선택합니다.
설명：
정책 템플릿은 기존 정책(사전 설정 또는 사용자 지정 정책)을 복사한 다음 정책을 수정하여 신규 정책을 생성하는 데 사용됩니다. 상황에 따라 적절한 정책 템플릿을 사용하여 정책 정의의 난이도와 작업량을 줄일 수 있습니다.
4. 다음을 클릭하고 필요에 따라 정책 이름을 수정합니다(또는 수정하지 않음).
5. 정책 내용 편집 상자에 정책 내용을 입력합니다. 본 예시의 정책 내용은 다음과 같습니다.
{"version": "2.0","statement":[{"effect": "allow","action": ["name/im:*"],"resource": ["qcs::im::uin/12345678:sdkappid/1400000001","qcs::im::uin/12345678:sdkappid/1400000002"]},{"effect": "deny","action": ["name/im:RemoveUser"],"resource": ["qcs::im::uin/12345678:sdkappid/1400000001"]}]}
설명：
6. 정책 생성을 클릭하여 사용자 정의 정책 생성을 완료합니다.
이 정책을 다른 서브 계정에 부여하는 방법은 기존 서브 계정에 IM 읽기/쓰기 액세스 권한 부여와 동일합니다.
CAM에서 제공하는 서버 API 사용
대부분의 개발자는 콘솔에서 권한 관리 작업을 수행하여 서비스 요구 사항을 충족할 수 있습니다. 그러나 권한 관리 기능을 자동화하고 체계화해야 하는 경우, 서버 API를 통해 실현할 수 있습니다.
정책 관련 서버 API는 CAM에 속하며, 자세한 사항은 CAM 공식 홈페이지 문서를 참고하시기 바랍니다. 다음은 몇 가지 주요 인터페이스 입니다.
예
아니오
문제 해결에 도움이 되었나요?