함수 역할 관리
적용 대상: ✅Microsoft Fabric✅Azure Data Explorer
보안 주체는 할당된 보안 역할이 리소스 액세스를 결정하는 역할 기반 액세스 제어 모델을 통해 리소스에 대한 액세스 권한을 부여받습니다.
함수에서 유일한 보안 역할은 .입니다 admins
. 함수는 함수 admins
를 보고, 수정하고, 제거할 수 있습니다.
이 문서에서는 관리 명령을 사용하여 기존 관리자를 보고 함수에 대한 관리자 를 추가 및 제거하는 방법을 알아봅니다.
참고 항목
보안 주체는 함수 관리자가 되려면 데이터베이스 또는 테이블 수준에서 액세스할 수 있어야 합니다.
사용 권한
이러한 명령을 실행하려면 데이터베이스 관리자 권한이 있거나 특정 함수에 대한 함수 관리자여야 합니다. 자세한 내용은 역할 기반 액세스 제어를 참조하세요.
기존 관리자 표시
보안 주체를 추가하거나 제거하기 전에 이 .show
명령을 사용하여 함수에 대한 관리자 액세스 권한이 이미 있는 모든 보안 주체가 있는 테이블을 볼 수 있습니다.
구문
모든 역할을 표시하려면 다음을 수행합니다.
.show
function
FunctionName principals
역할을 표시하려면 다음을 수행합니다.
.show
function
FunctionName principal
roles
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
이름 | Type | 필수 | 설명 |
---|---|---|---|
FunctionName | string |
✔️ | 보안 주체를 나열할 함수의 이름입니다. |
예시
다음 명령은 함수에 액세스할 수 있는 모든 보안 주체를 나열합니다 SampleFunction
.
.show function SampleFunction principals
예제 출력
역할 | PrincipalType | PrincipalDisplayName | PrincipalObjectId | PrincipalFQN |
---|---|---|---|---|
Function SampleFunction 관리자 | Microsoft Entra 사용자 | 아비 앳킨스 | cd709aed-a26c-e3953dec735e | aaduser=abbiatkins@fabrikam.com |
관리자 추가 및 삭제
이 섹션에서는 보안 주체를 추가 및 제거하기 위한 구문, 매개 변수 및 예제를 제공합니다.
구문
Action function
FunctionName (
admins
Principal [,
Principal...] )
[skip-results
] [ Description ]
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
이름 | Type | 필수 | 설명 |
---|---|---|---|
동작 | string |
✔️ | 명령 .add 또는 .drop .set ..add 는 지정된 보안 주체를 .drop 추가하고, 지정된 보안 주체를 제거하고, 지정된 보안 주체를 추가하고, .set 이전 보안 주체를 모두 제거합니다. |
FunctionName | string |
✔️ | 보안 주체를 추가할 함수의 이름입니다. |
주 서버 | string |
✔️ | 하나 이상의 보안 주체. 이러한 보안 주체를 지정하는 방법에 대한 지침은 보안 주체 참조를 참조 하세요. |
skip-results |
string |
제공된 경우 명령은 업데이트된 함수 보안 주체 목록을 반환하지 않습니다. | |
설명 | string |
명령을 사용할 .show 때 표시되는 변경 내용을 설명하는 텍스트입니다. |
참고 항목
.set
보안 주체 목록 대신 명령을 none
사용하면 모든 보안 주체가 제거됩니다.
예제
다음 예제에서는 관리자를 추가하고, 관리자를 제거하고, 동일한 명령에서 관리자를 추가 및 제거하는 방법을 확인할 수 있습니다.
.add를 사용하여 관리자 추가
다음 예제에서는 함수의 admins
역할에 보안 주체를 추가합니다 SampleFunction
.
.add function SampleFunction admins ('aaduser=imikeoein@fabrikam.com')
.drop을 사용하여 관리자 제거
다음 예제에서는 함수의 역할에서 admins
그룹의 모든 보안 주체를 제거합니다 SampleFunction
.
.drop function SampleFunction admins ('aadGroup=SomeGroupEmail@fabrikam.com')
새 관리자를 추가하고 .set을 사용하여 이전 관리자를 제거합니다.
다음 예제에서는 기존 admins
개체를 제거하고 제공된 보안 주체를 함수와 SampleFunction
같이 admins
추가합니다.
.set function SampleFunction admins ('aaduser=imikeoein@fabrikam.com', 'aaduser=abbiatkins@fabrikam.com')
.set을 사용하여 모든 관리자 제거
다음 명령은 함수에 있는 모든 기존 admins
기능을 SampleFunction
제거합니다.
.set function SampleFunction admins none