환경 준비 및 사용자 등록
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Android Management API (AMAPI) SDK는 새로운 맞춤 기기 정책 컨트롤러 (DPC) 등록 흐름에서 중요한 역할을 합니다. EMM 맞춤 DPC 앱과 Android 기기 정책 (ADP) 간의 통신을 지원하고 주요 등록 기능을 위해 Play EMM API와 상호작용하여 기기 등록을 간소화합니다.
AMAPI SDK의 주요 기능은 다음과 같습니다.
- EMM DPC 앱과 Android Device Policy 간의 통신을 사용 설정합니다.
- 명령어의 로컬 실행을 지원합니다.
- 관리 Google 계정을 추가하기 위한 새 기기 등록 흐름을 지원합니다.
- 필요한 경우 Android Device Policy의 설치 또는 업데이트를 관리합니다.
SDK는 맞춤 DPC 등록 흐름에서 다음 두 가지 기본 이유로 필수적입니다.
기기에 Android Device Policy를 올바르게 설치하고 업데이트하도록 지원하여 환경을 설정합니다.
Android 기기 정책을 로컬로 호출하는 데 사용되며, 이는 기기에서 사용자 로그인 시퀀스를 시작합니다.
이러한 기본 기능은 기기를 관리에 대비하고 후속 등록 단계를 가능하게 합니다.
환경
AMAPI SDK의 EnvironmentClient는 환경 관련 API에 액세스할 수 있는 인터페이스입니다. EnvironmentClientFactory를 사용하여 인스턴스를 만들 수 있습니다.
EnvironmentClient의 주요 기능:
- SDK API 수준이 최소 요구사항을 충족하는지 확인합니다.
- 필요한 경우 Google Play 서비스 업데이트를 확인하고 시작합니다.
- Android Device Policy가 설치되고 업데이트되었는지 확인합니다. 설치 또는 업데이트가 포함될 수 있으므로 이 프로세스에 시간이 걸릴 수 있습니다.
EnvironmentClient 인터페이스에 관한 자세한 내용은 참조 문서를 확인하세요.
AccountSetup
AMAPI SDK 내의 AccountSetup 클래스는 관리 Android 기기에서 Google 계정을 설정하는 프로세스를 관리합니다.
AccountSetup의 주요 기능은 다음과 같습니다.
AccountSetupClient 및 등록 토큰을 사용하여 계정 설정 프로세스를 시작합니다.- EMM에서 생성되고 AMAPI SDK에 전달되는 등록 토큰을 처리합니다. 이 토큰은 사용자 인증이 필요한지 여부를 결정합니다.
- 필요한 경우 인증 활동을 실행하여 사용자에게 Google 사용자 인증 정보로 로그인하라는 메시지를 표시합니다.
- 로그인이 성공하면 사용자의 이메일과 사용자 ID가 포함된 콜백을 수신합니다.
- EMM은 수신된 사용자 식별자를 사용하여
Devices.update 메서드로 기기 정책을 설정합니다.
- EMM은
Devices.setState를 호출하여 기기를 규정 준수로 표시하고 Google 서비스에 대한 액세스를 허용합니다.
이 기능은 DPC 지원 라이브러리 대신 AMAPI SDK를 활용하는 새로운 기기 등록 방법의 일부입니다. AccountSetup에 관한 자세한 내용은 AMAPI 참조 문서 및 사용자 계정 구현 가이드를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-25(UTC)
[null,null,["최종 업데이트: 2025-08-25(UTC)"],[],[],null,["# Environment preparation and user enrollment\n\nThe Android Management API (AMAPI) SDK plays a important role in the new custom\nDevice Policy Controller (DPC) enrollment flow. It facilitates communication\nbetween EMM custom DPC apps and Android Device Policy (ADP) and streamlines\ndevice enrollment by interacting with the Play EMM API for key enrollment\nfunctions.\n\nKey functions of the AMAPI SDK:\n-------------------------------\n\n- Enables communication between EMM DPC apps and Android Device Policy.\n- Facilitates local execution of commands.\n- Supports the new device enrollment flow for adding managed Google Accounts.\n- Manages the installation or updates of Android Device Policy when needed.\n\nThe SDK is essential for two primary reasons in the custom DPC enrollment flow:\n\n1. It sets the environment by helping to install and update Android Device\n Policy correctly on the device.\n\n2. It is used to call Android Device Policy locally, which initiates the user\n login sequence on the device.\n\nThese foundational functions prepare the device for management and make the\nsubsequent enrollment steps possible.\n\n*** ** * ** ***\n\nEnvironment\n-----------\n\nThe AMAPI SDK's `EnvironmentClient` is an interface that allows access to\nenvironment-related APIs. You can create an instance using\n`EnvironmentClientFactory`.\n\n### Key features of the `EnvironmentClient`:\n\n- Makes sure the SDK API level meets the minimum requirement.\n- Checks for and initiates an update for Google Play services if needed.\n- Verifies that Android Device Policy is installed and updated. Be aware that this process can take some time as it may involve an installation or update.\n\nFor more details on the `EnvironmentClient` interface, see the [reference\ndocumentation](/android/management/reference/amapi/com/google/android/managementapi/environment/EnvironmentClient).\n\n*** ** * ** ***\n\nAccountSetup\n------------\n\nThe `AccountSetup` class within the AMAPI SDK is responsible for managing the\nprocess of setting up a Google Account on a managed Android device.\n\n### Key features of the AccountSetup:\n\n- Starts the account setup process using the `AccountSetupClient` and an enrollment token.\n- Handles the enrollment token, which is generated by the EMM and passed to the AMAPI SDK. This token determines whether user authentication is required.\n- Launches an authentication activity if needed, prompting the user to sign in with their Google credentials.\n- Receives a callback with the user's email and user ID upon successful sign-in.\n- The EMM uses the received user identifiers to set the device policy with the [`Devices.update`](/android/work/play/emm-api/v1/devices/update) method.\n- The EMM calls [`Devices.setState`](/android/work/play/emm-api/v1/devices/setState) to mark the device as compliant and allow access to Google services.\n\nThis functionality is part of a new device enrollment method that leverages the\nAMAPI SDK instead of the DPC support library. For more details on `AccountSetup`\nsee [AMAPI reference\ndocumentation](/android/management/reference/amapi/com/google/android/managementapi/accountsetup/package-summary)\nand [Implement the user accounts\nguide](/android/work/play/emm-api/implement-user-accounts)."]]
