범위가 지정된 역할 만들기 및 관리

빠른 설정

조직 또는 호텔에서 약 5분 안에 역할을 만들거나 업데이트할 수 있습니다.

이 가이드에서는 허용된 범위 내에서 역할을 만들고, 편집하고, 검토하는 방법을 설명합니다.

빠른 참조

작업	이동할 위치	결과
템플릿 없이 만들기	Create New Role → Start from scratch	복사된 권한이 없는 빈 역할을 엽니다
템플릿 사용	Create New Role	역할 세부 정보와 권한을 미리 입력합니다
목록에 있는 역할 복사	Roles 행 작업	해당 역할이 선택된 생성 양식을 엽니다
역할 편집	Roles 행 작업 → Edit	기존 역할에 허용된 변경 사항을 저장합니다
할당 관리	Account Management → Permissions	선택한 컨텍스트에서 직원 역할을 변경하거나 제거합니다
작업 찾기	Search features or actions…	기능 이름, 설명, 작업 설명 또는 권한 코드를 검색합니다
액세스 검토	Selected actions only 및 Review changes	현재 선택 항목과 추가되거나 제거된 액세스를 표시합니다
수정 내용 초기화	Reset to source role	선택한 소스 값을 복원합니다
복사본 저장	Create Role	독립적인 맞춤 역할을 만듭니다
할당된 사용자 찾기	Roles 행 작업 → View assigned users	해당 역할로 필터링된 계정 결과를 엽니다
사용하지 않는 범위 지정 역할 삭제	Roles 행 작업 → Delete Role	할당되지 않은 맞춤 역할을 카탈로그에서 제거합니다

시작하기 전에

• Superadmin 액세스 권한으로 로그인하거나 user:permissions가 있는 관리자 역할을 사용합니다.
• 소스 역할에 필요한 권한이 있는지 확인합니다.
• 새 역할을 전역, 조직 또는 한 호텔에 적용할지 결정합니다.

조직 및 호텔 관리자는 자신이 허용된 컨텍스트에 속한 역할만 관리할 수 있습니다. 다른 호텔의 역할을 만들거나 편집하거나 자신의 한도를 초과하는 권한을 부여할 수 없습니다. 역할 카탈로그에는 선택한 조직 또는 호텔에서 사용할 수 있는 역할만 표시됩니다. 범위가 지정된 권한 카탈로그에는 현재 AVA에서 지원하는 권한만 표시됩니다. 사용 중지된 권한은 새 역할 양식이나 할당 선택 항목에 표시되지 않습니다.

전역 템플릿

액세스 권한이 허용되는 경우 전역 템플릿을 시작점으로 계속 사용할 수 있습니다. 템플릿을 복사하면 선택한 범위에 독립적인 역할이 만들어집니다.

독립적인 복사본

새 역할은 소스 역할과 지속적으로 연결되지 않습니다. 한 역할을 변경해도 다른 역할은 업데이트되지 않습니다.

전역 기본 제공 역할 편집

범위가 전역인 경우 저장된 기본 제공 역할을 편집할 수 있습니다. AVA는 변경 사항을 저장할 때 역할을 전역으로 유지합니다. 편집 양식에서는 Role Name, Description 및 Permissions를 변경할 수 있습니다. 전역 기본 제공 역할에서는 Role Scope 필드가 잠깁니다.

1. Superadmin → Permissions → Roles로 이동하거나 관리자 계정에서 사용할 수 있는 역할 영역을 엽니다.

2. 변경할 전역 기본 제공 역할을 찾습니다.

3. Edit를 클릭합니다.

4. Role Name, Description 또는 Permissions를 업데이트합니다.

5. Role Scope가 Global로 유지되는지 확인합니다.

6. Update Role을 클릭합니다.

   ✓ AVA가 기존 전역 기본 제공 역할에 변경 사항을 저장합니다.

기본 제공 역할을 전역으로 유지하세요

기본 제공 역할의 범위를 조직 또는 호텔 범위로 변경하지 마세요. AVA는 기본 제공 역할의 범위 변경을 거부합니다. 전역이 아닌 기본 제공 역할은 편집할 수 없습니다.

템플릿 없이 역할 만들기

기존 역할을 복사하지 않고 범위가 지정된 역할을 만들 수 있습니다.

1. Superadmin → Permissions → Roles로 이동합니다.

2. Add New Role을 클릭합니다.

3. Start from scratch를 선택합니다.

4. 역할 세부 정보를 입력하고 필요한 권한을 선택합니다.

5. 허용된 Role Scope와 할당을 선택합니다.

6. Create Role을 클릭합니다.

   ✓ AVA가 선택한 권한만 포함하는 맞춤 역할을 만듭니다.

역할 템플릿 선택

1. Superadmin → Permissions → Roles로 이동합니다.

2. Add New Role을 클릭합니다.

3. Start from an existing role을 엽니다.

4. 시스템 역할 또는 맞춤 역할을 검색합니다.

5. 시작점으로 사용할 역할을 선택합니다.

   ✓ AVA가 역할 이름, 설명, 범위, 할당 및 권한을 미리 입력합니다.

복사된 이름은 Copy of로 시작합니다. 권한 목록은 admin:billing과 같은 표준 콜론 구분 키를 사용합니다.

역할 목록에서 직접 역할 복사

빈 양식을 열지 않고 특정 역할에서 바로 시작할 수 있습니다.

1. Roles 목록에서 소스 역할을 찾습니다.

2. Create based on this role을 클릭합니다.

3. 미리 입력된 세부 정보와 권한을 검토합니다.

   ✓ 해당 역할이 소스로 선택된 동일한 생성 양식이 열립니다.

새 역할 맞춤 설정

1. Role Name 및 Description을 편집합니다.

2. Role Scope를 선택합니다.

3. 범위에 하나가 필요한 경우 Organization 또는 Hotel을 선택합니다.

4. 그룹화된 권한 편집기에서 작업을 선택하거나 선택 해제합니다.

5. 기능 설명과 작업 설명을 검토합니다.

6. 상속된 권한, 추가된 권한 및 제거된 권한의 수를 검토합니다.

7. 선택한 권한이 허용된 부여 한도를 초과하지 않는지 확인합니다.

8. Create Role을 클릭합니다.

   ✓ AVA가 편집한 권한 집합으로 새 맞춤 역할을 저장합니다.

범위를 신중하게 검토하세요

범위를 변경하면 선택한 조직 또는 호텔이 지워집니다. 저장하기 전에 필요한 할당을 다시 선택합니다.

범위가 지정된 역할 편집

조직 또는 호텔 범위에 속한 맞춤 역할을 편집할 수 있습니다. 허용된 권한 부여 한도 내에서 이름, 설명 및 권한을 변경할 수 있습니다.

1. 현재 조직 또는 호텔의 Roles 목록을 엽니다.

2. 맞춤 역할을 찾아 Edit를 클릭합니다.

3. 역할 범위와 현재 할당을 검토합니다.

4. Role Name, Description 또는 Permissions를 업데이트합니다.

5. Update Role을 클릭합니다.

   ✓ AVA는 역할의 범위와 권한이 계속 허용되는 경우에만 역할을 저장합니다.

범위 및 권한 제한

AVA는 현재 컨텍스트 밖에 있는 역할에 대한 변경을 거부합니다. 또한 사용자의 허용된 권한 부여 한도를 초과하는 권한도 거부합니다.

할당되지 않은 범위 지정 역할 삭제

조직 또는 호텔이 소유한 맞춤 역할을 삭제할 수 있습니다. 역할에는 할당된 계정이 없어야 합니다.

1. 현재 조직 또는 호텔의 Roles 목록을 엽니다.

2. 맞춤 역할을 찾아 할당된 계정 수를 검토합니다.

3. 사용자가 할당되어 있으면 View assigned users를 클릭합니다.

4. 나열된 모든 계정을 재할당하거나 제거합니다.

5. Roles 목록으로 돌아가 Delete Role을 클릭합니다.

6. 삭제를 확인합니다.

   ✓ 사용하지 않는 역할이 사용 가능한 역할 카탈로그에서 사라집니다.

할당된 역할은 삭제할 수 없습니다

먼저 모든 계정을 재할당하거나 제거하세요. 기본 제공, 전역, 비소유 및 범위 밖의 역할은 삭제할 수 없습니다.

역할에 할당된 사용자 찾기

하나의 역할에 할당된 모든 사용자를 검토하거나 변경해야 할 때 역할 작업을 사용합니다.

1. 현재 조직 또는 호텔의 Roles 목록을 엽니다.

2. 역할을 찾아 View assigned users를 클릭합니다.

3. 해당 역할로 필터링된 계정 목록을 검토합니다.

4. 조직 결과를 좁혀야 할 때 Filter by Hotel을 사용합니다.

5. Account Management에서 할당을 변경하거나 제거합니다.

   ✓ AVA는 결과를 검토하는 동안 선택한 역할 및 호텔 필터를 유지합니다.

정확한 역할 필터링

계정 목록은 페이지 매김 전에 선택한 역할 필터를 전송합니다. 따라서 결과가 해당 역할에 할당된 사용자로 제한됩니다.

직원 역할 할당 또는 제거

Account Management → Permissions를 사용하여 직원의 역할 할당을 관리합니다. user:permissions 액세스 권한이 필요하며, 허용된 할당만 관리할 수 있습니다.

1. 조직 또는 호텔 컨텍스트에서 Account Management를 엽니다.

2. 직원을 찾아 Permissions를 클릭합니다.

3. Organization access 또는 특정 Hotel access 항목을 선택합니다.

4. 사용 가능한 카탈로그에서 역할을 선택합니다.

5. Update Role을 클릭합니다.

   ✓ AVA가 선택한 할당을 업데이트하고 컨텍스트 밖의 할당은 변경하지 않습니다.

할당을 제거하려면 해당 할당을 선택하고 Remove Role을 클릭한 다음 확인합니다. AVA는 사용자의 현재 역할을 보호하며 허용된 범위 밖의 변경을 거부합니다.

조직 및 호텔 전환

조직 액세스와 호텔 액세스 사이를 변경하면 직원의 현재 액세스 유형이 바뀔 수 있습니다. 저장하기 전에 확인 내용을 검토합니다. 선택한 컨텍스트에서 허용하는 경우 독립적인 호텔 할당은 별도로 유지됩니다.

직원 추가 시 범위가 지정된 역할 사용

계정 생성 및 초대에는 역할 할당과 동일한 범위 규칙이 적용됩니다. 조직 또는 호텔을 선택하면 역할 선택 항목이 새로 고쳐집니다.

1. Account Management를 엽니다.

2. Add Account 또는 Invite User를 선택합니다.

3. Organization access 또는 Hotel access를 선택합니다.

4. 호텔 액세스의 경우 각 호텔을 선택하고 역할을 개별적으로 선택합니다.

5. 조직 액세스의 경우 조직 역할을 선택합니다.

6. Create Account 또는 Send Invite를 선택합니다.

   ✓ AVA가 허용된 범위 밖의 호텔에 속한 역할을 제외합니다.

역할을 선택하기 전에 범위를 변경하세요

선택한 호텔을 변경하면 역할 선택이 지워집니다. 새로 고쳐진 역할 목록이 표시될 때까지 기다린 다음 역할을 다시 선택합니다.

권한 찾기 및 검토

권한 편집기는 기능별로 작업을 그룹화합니다. 각 기능은 기본적으로 접혀 있으므로 역할을 빠르게 훑어볼 수 있습니다.

1. 기능을 열어 설명과 사용 가능한 작업을 검토합니다.

2. **Search features or actions…**를 사용하여 설명 또는 기술 권한 코드를 검색합니다.

3. Feature 필터를 사용하여 하나의 기능만 표시합니다.

4. Selected actions only를 선택하여 선택하지 않은 작업을 숨깁니다.

5. 기능 체크박스를 사용하여 해당 기능의 모든 작업을 선택하거나 선택 해제합니다.

6. Review changes를 펼쳐 추가 및 제거된 액세스를 확인합니다.

   ✓ 각 현재 권한에는 해당 권한이 허용하는 작업에 대한 직접적인 설명이 표시됩니다. 지원 및 문제 해결을 위해 기술 권한 코드는 아래에 계속 표시됩니다.

기존 권한

현재 카탈로그에 없는 권한은 사용 중지된 권한입니다. 오래된 역할을 정리하려면 해당 역할을 편집, 회수, 교체 또는 삭제할 수 있습니다. 사용 중지된 권한은 해당 역할을 다른 계정에 할당하기 전에 제거합니다.

AVA는 가능한 경우 번역된 설명 또는 API에서 제공한 설명을 사용합니다. 두 설명을 모두 확인할 수 없으면 AVA는 현지화된 Unrecognized permission 메시지를 표시합니다. 이 메시지에는 내부 번역 키 대신 읽을 수 있는 권한 코드가 포함됩니다.

Video Call 액세스 관리

Video Call 권한은 Communication 카테고리에 표시됩니다. 직원이 Video Call 워크플로의 일부만 필요로 하는 경우 해당 권한을 독립적으로 할당합니다.

권한	부여되는 액세스
video_call:settings:manage	진입점, 일정 및 관련 설정을 보고 변경합니다
video_call:activity:read	Video Call 활동 및 녹취를 봅니다
video_call:activity:manage	활동 및 녹취를 보고, 통화를 회수하고, 활동 분석을 실행합니다
video_call:device_pairing:manage	계정 소유 AVA Alarm 장치 페어링 제어를 관리합니다

기본 제공 Owner 및 Hotel Manager 역할에는 네 가지 권한이 모두 포함됩니다. 맞춤 역할에는 사용자가 선택한 작업만 포함됩니다.

General Settings 권한은 더 이상 Video Call 액세스 권한을 부여하지 않습니다. Video Call이 필요한 모든 맞춤 역할에는 전용 권한을 사용합니다. video_call:activity:read는 보기만 허용합니다. video_call:activity:manage는 통화 회수 및 활동 분석도 허용합니다. 로그인한 직원은 계정 페어링을 사용할 수 있는 경우에도 자신의 모바일 장치를 페어링할 수 있습니다.

1. Superadmin → Permissions → Roles에서 역할 편집기를 엽니다.

2. Video Call을 검색하거나 Communication을 엽니다.

3. 역할에 필요한 작업을 선택합니다.

4. 변경 사항을 검토한 다음 Create Role 또는 Update Role을 클릭합니다.

   ✓ 역할에는 선택한 Video Call 기능만 부여됩니다.

Phone AI 및 Voice Translation 액세스 관리

Phone AI 및 Voice Translation 권한은 Communication 카테고리에 표시됩니다. 직원이 광범위한 Settings 액세스 없이 한 가지 기능만 필요로 하는 경우 해당 권한을 독립적으로 할당합니다.

권한	부여되는 액세스
phone_ai:read	Phone AI를 열고 통화 활동 및 녹취를 검토합니다
phone_ai:manage	Phone AI를 구성하고 테스트하고 활성화합니다
voice_translation:read	Voice Translation 설정을 봅니다
voice_translation:manage	Voice Translation 설정을 변경합니다

각 manage 권한은 일치하는 read 권한도 부여합니다. 읽기 액세스는 관리 액세스를 부여하지 않습니다. General Settings 권한은 이러한 새로운 기능 권한을 부여하지 않습니다.

1. Superadmin → Permissions → Roles에서 역할 편집기를 엽니다.

2. Phone AI 또는 Voice Translation을 검색합니다.

3. 역할에 필요한 작업을 선택합니다.

4. 변경 사항을 검토한 다음 Create Role 또는 Update Role을 클릭합니다.

   ✓ 역할에는 선택한 Phone AI 및 Voice Translation 기능만 부여됩니다.

역할을 편집하지 않고 검토

역할을 변경하지 않고 액세스를 검토하려면 역할 세부 정보를 열 수 있습니다.

1. Superadmin → Permissions → Roles로 이동합니다.

2. 검사할 역할을 찾습니다.

3. View permissions를 클릭합니다.

4. 기능별로 그룹화된 권한 내역을 검토합니다.

   ✓ 세부 정보 보기에는 역할 설명, 할당된 계정 수 및 부여된 작업이 표시됩니다.

시작 역할 초기화 또는 교체

저장하기 전에 수정 내용을 초기화하거나 다른 소스 역할을 선택할 수 있습니다.

수정 내용 초기화

1. Reset to source role을 클릭합니다.

2. 확인 메시지를 검토합니다.

3. Reset role을 클릭합니다.

   ✓ 양식이 선택한 소스 역할의 세부 정보와 권한으로 돌아갑니다.

다른 소스 선택

1. 역할 템플릿 검색 필드를 엽니다.

2. 다른 역할을 선택하거나 Start from scratch를 선택합니다.

3. 확인 메시지를 검토합니다.

4. Use this role 또는 Start from scratch를 클릭합니다.

   ✓ AVA는 확인한 후에만 양식 값을 교체합니다.

저장하지 않은 수정 내용

다른 소스를 선택하면 이름, 설명, 범위, 할당 및 권한이 교체될 수 있습니다. 수정 내용을 유지해야 한다면 확인을 취소합니다.

보이는 문제 → 해결 방법

역할 템플릿이 계속 로드 중인 경우

보이는 문제: 템플릿 필드에 **Loading available role templates...**가 표시됩니다.

해결 방법: 역할 목록의 로드가 완료될 때까지 기다린 다음 다시 검색합니다. 로드에 실패하면 빈 역할을 만들고 권한을 수동으로 선택합니다.

소스를 변경한 후 수정 내용이 사라지는 경우

보이는 문제: 소스를 선택한 후 양식에 다른 역할의 세부 정보가 표시됩니다.

해결 방법: 소스를 변경하기 전에 확인을 취소합니다. 확인했다면 수정 내용을 다시 입력하거나 올바른 소스 역할을 다시 사용합니다.

복사한 역할의 범위가 잘못된 경우

보이는 문제: 복사한 역할이 소스 역할의 조직 또는 호텔을 대상으로 합니다.

해결 방법: 올바른 Role Scope를 선택합니다. 그런 다음 역할을 만들기 전에 필요한 Organization 또는 Hotel을 선택합니다.

복사한 권한이 누락된 것처럼 보이는 경우

보이는 문제: 레거시 역할의 권한이 권한 카탈로그에 표시되지 않습니다.

해결 방법: 해당 권한이 사용 중지되었는지 확인하고 복사한 역할에서 제거합니다. 역할을 저장한 다음 다시 열어 현재 권한을 확인합니다.

AVA는 새 역할과 역할 할당에서 사용 중지된 권한을 제외합니다.

권한 설명을 인식할 수 없는 경우

보이는 문제: 권한에 Unrecognized permission과 읽을 수 있는 코드가 표시됩니다.

해결 방법: 권한 코드를 검토하고 액세스가 예상된 것이라면 해당 권한을 유지합니다. 부여되는 액세스를 확인할 수 없으면 지원팀에 문의합니다.

선택한 역할을 만들거나 편집할 수 없는 경우

보이는 문제: AVA가 역할 작업을 숨기거나 저장을 거부합니다.

해결 방법: user:permissions 액세스 권한이 있는지 확인합니다. 역할을 소유한 조직 또는 호텔로 전환한 다음 다시 시도합니다. 더 넓은 범위 또는 권한 부여가 필요하면 상위 관리 권한이 있는 관리자에게 요청합니다.

역할 할당이 거부되는 경우

보이는 문제: AVA가 Update Role 또는 Remove Role을 거부합니다.

해결 방법: 직원과 선택한 할당이 현재 컨텍스트에 속하는지 확인합니다. 사용자의 현재 역할을 변경하지 마세요. 사용 가능한 카탈로그에서 역할을 선택한 다음 다시 시도합니다.

역할에 사용 중지된 권한이 포함되어 있으면 먼저 역할을 편집하여 해당 권한을 제거합니다. 그런 다음 역할을 저장하고 할당을 다시 시도합니다.

Delete Role이 비활성화된 경우

보이는 문제: Delete Role이 비활성화되어 있거나 AVA가 역할이 할당되었다고 표시합니다.

해결 방법:

1. 해당 역할에서 View assigned users를 클릭합니다.
2. 나열된 각 계정을 재할당하거나 제거합니다.
3. 할당된 수가 0이 되면 역할 목록으로 돌아갑니다.
4. Delete Role을 다시 시도합니다.

역할 삭제가 거부되는 경우

보이는 문제: AVA가 범위 또는 소유권 메시지와 함께 삭제를 거부합니다.

해결 방법: 역할이 현재 조직 또는 호텔이 소유한 맞춤 역할인지 확인합니다. 소유한 컨텍스트로 전환한 다음 다시 시도합니다.

호텔을 변경한 후 역할 목록이 비어 있는 경우

보이는 문제: 다른 호텔을 선택한 후 역할이 표시되지 않거나 목록이 잠시 새로 고쳐집니다.

해결 방법: 호텔별 역할이 로드될 때까지 기다립니다. 목록이 계속 비어 있으면 해당 호텔이 허용된 범위에 속하는지 확인합니다. 그런 다음 계정 또는 초대 양식을 닫았다가 다시 엽니다.

AVA는 백그라운드에서 새로 고치는 동안 이전에 로드된 역할 결과를 계속 표시합니다. 따라서 최신 결과가 로드되는 동안에도 역할을 계속 검토할 수 있습니다.

여전히 해결되지 않나요?

다음과 같은 경우 success@vouch-technologies.com으로 문의하세요.

• ❌ 역할 템플릿의 로드가 끝나지 않음
• ❌ 확인한 변경 사항이 저장 후 표시되지 않음
• ❌ 새 역할의 권한 또는 범위가 잘못됨

소스 역할 이름, 새 역할 이름, 스크린샷 및 문제가 발생한 시간을 포함하세요.

관련 가이드

• 역할 권한이 저장되지 않음
• 다중 속성 액세스 설정
• 계정 설정