6월 3일의 ⁠#Android11: 베타 버전 출시 행사에 참여하세요.

<permission>

구문
<permission android:description="string resource"
                android:icon="drawable resource"
                android:label="string resource"
                android:name="string"
                android:permissionGroup="string"
                android:protectionLevel=["normal" | "dangerous" |
                                         "signature" | ...] />
포함된 요소
<manifest>
설명
이 애플리케이션이나 다른 애플리케이션의 특정 구성요소 또는 기능에 대한 액세스를 제한하는 데 사용될 수 있는 보안 권한을 선언합니다. 권한 작동 방식에 관한 자세한 내용은 소개의 권한 섹션과 보안 및 권한 문서를 참조하세요.
속성
android:description
권한에 관한 사용자가 읽을 수 있는 설명으로 라벨보다 길고 더 많은 정보를 제공합니다. 사용자에게 다른 애플리케이션에 권한을 부여할지 여부를 묻는 등 사용자에게 권한을 설명하기 위해 표시될 수 있습니다.

이 속성은 문자열 리소스의 참조로 설정해야 하며 label 속성과 달리 원시 문자열일 수 없습니다.

android:icon
권한을 나타내는 아이콘의 드로어블 리소스의 참조입니다.
android:label
권한 이름으로, 사용자에게 표시될 수 있습니다.

애플리케이션을 개발하는 동안 편의를 위해 라벨을 직접 원시 문자열로 설정할 수 있습니다. 그러나 애플리케이션을 게시할 준비가 되면 사용자 인터페이스의 다른 문자열처럼 현지화할 수 있도록 라벨을 문자열 리소스의 참조로 설정해야 합니다.

android:name
권한 이름입니다. 코드에서 권한을 참조하는 데 사용될 이름입니다(예: <uses-permission> 요소 및 애플리케이션 구성요소의 permission 속성).

참고: 모든 패키지가 동일한 인증서로 서명되지 않으면 여러 패키지가 이름이 동일한 권한을 선언할 수 없습니다. 패키지에서 권한을 선언하면 이러한 패키지가 첫 번째 패키지와 동일한 인증서로 서명되지 않는 한 사용자가 동일한 권한 이름으로 다른 패키지를 설치할 수 없습니다. 이름 충돌을 피하려면 맞춤 권한에 역 도메인 스타일 이름 지정(예: com.example.myapp.ENGAGE_HYPERSPACE)을 사용하는 것이 좋습니다.

android:permissionGroup
그룹에 이 권한을 할당합니다. 이 속성의 값은 그룹의 이름으로, 이 애플리케이션이나 다른 애플리케이션에 <permission-group> 요소로 선언되어야 합니다. 이 속성을 설정하지 않으면 권한이 그룹에 속하지 않습니다.
android:protectionLevel

권한에 내포된 잠재적 위험을 특성화하고 권한을 요청하는 애플리케이션에 권한을 부여할지 여부를 결정할 때 시스템에서 따라야 하는 절차를 나타냅니다.

각 보호 수준은 기본 권한 유형과 0개 이상의 플래그로 구성됩니다. 예를 들어 "dangerous" 보호 수준에는 플래그가 없습니다. 반면 보호 수준 "signature|privileged""signature" 기본 권한 유형과 "privileged" 플래그의 조합입니다.

다음 표에서는 모든 기본 권한 유형을 보여줍니다. 플래그 목록은 protectionLevel을 참조하세요.

의미
'normal' 기본값입니다. 다른 애플리케이션, 시스템, 사용자의 위험을 최소화하면서 권한을 요청하는 애플리케이션에 격리된 애플리케이션 수준 기능에 대한 액세스 권한을 제공하는 위험성이 낮은 권한입니다. 시스템에서는 사용자의 명시적인 승인을 요구하지 않고 설치 시 권한을 요청하는 애플리케이션에 이러한 유형의 권한을 자동으로 부여합니다. 하지만 사용자는 설치 전에 항상 이러한 권한을 검토할 수 있습니다.
'dangerous' 권한을 요청하는 애플리케이션에 비공개 사용자 데이터에 대한 액세스 권한 또는 사용자에게 부정적인 영향을 줄 수 있는 기기 제어 권한을 부여하는 위험성이 높은 권한입니다. 이러한 유형의 권한은 잠재적인 위험을 초래하므로 시스템에서 권한을 요청하는 애플리케이션에 권한을 자동으로 부여하지 않을 수 있습니다. 예를 들어 애플리케이션에서 위험한 권한을 요청하면 사용자에게 표시하고 계속 진행하기 전에 확인을 요청하거나 사용자가 이러한 기능의 사용을 자동으로 허용하지 않도록 기타 다른 접근 방식을 취할 수 있습니다.
'signature' 권한을 요청하는 애플리케이션이 권한을 선언한 애플리케이션과 동일한 인증서로 서명한 경우에만 시스템에서 부여하는 권한입니다. 인증서가 일치하면 시스템에서는 사용자에게 알리거나 사용자의 명시적인 승인을 요청하지 않고 자동으로 권한을 부여합니다.
'signatureOrSystem'

"signature|privileged"의 이전 동의어로, API 레벨 23에서 지원이 중단되었습니다.

Android 시스템 이미지의 전용 폴더에 있는 애플리케이션 또는 권한을 선언한 애플리케이션과 동일한 인증서로 서명된 애플리케이션에만 부여되는 권한입니다. signature 보호 수준은 대부분의 요구사항에 부합하며 앱이 설치된 정확한 위치와 관계없이 작동하므로 이 옵션은 사용하지 않는 것이 좋습니다. 여러 공급업체가 시스템 이미지에 빌드된 애플리케이션을 보유하고 이러한 애플리케이션이 함께 빌드되어 특정 기능을 명시적으로 공유해야 하는 특수한 상황에서 'signatureOrSystem' 권한이 사용됩니다.

도입 시기
API 레벨 1
참고 항목
<uses-permission>
<permission-tree>
<permission-group>