Эта страница переведена с помощью Cloud Translation API.

Авторизация

Приложения авторизуют вызовы клиентского API автоматической регистрации с помощью OAuth . В этом документе объясняется авторизация API для поставщиков управления мобильностью предприятия (EMM) и корпоративных ИТ-разработчиков. Прочитав этот документ, вы узнаете, как авторизовать запросы API в вашем приложении, и объясните требования к учетной записи пользователям вашего приложения.

Краткое руководство по авторизации

Чтобы настроить проект Google Cloud Platform с API автоматической регистрации и секретами клиента OAuth, запустите этот мастер .
Создайте пример кода быстрого запуска для Java , .NET или Python . Используйте клиентские библиотеки API Google для поддержки других языков.

Обзор

Взаимоотношения устройств и ресурсов клиента

Один или несколько ИТ-администраторов являются пользователями учетной записи клиента с автоматической регистрацией.
ИТ-администраторы используют учетную запись Google для аутентификации.
Запросы API передают токен OAuth2 для авторизации запросов API от имени ИТ-администратора.

Счета клиентов

Конфигурации, устройства и пользователи (ИТ-администраторы) организации принадлежат учетной записи клиента. Учетная запись клиента аналогична группе и не является отдельным пользователем. Реселлер настраивает клиента, когда организация впервые приобретает устройства для автоматической регистрации. ИТ-администраторы управляют другими пользователями в своей организации с помощью портала автоматической регистрации.

API использует числовые идентификаторы клиентов для идентификации учетных записей. Вы передаете идентификатор клиента как часть URL-пути при вызове методов API. Вашему приложению необходимо получить идентификатор клиента пользователя перед вызовом каких-либо методов API.

В приведенном ниже примере показано, как получить учетные записи клиентов для пользователя, который авторизует вызов API:

Ява

AndroidProvisioningPartner.Customers.List accountRequest = service.customers().list();
accountRequest.setPageSize(100);
CustomerListCustomersResponse accountResponse = accountRequest.execute();

List<Company> customers = accountResponse.getCustomers();
if (customers == null || customers.isEmpty()) {
    // No accounts found for the user. Confirm the Google Account
    // that authorizes the request can access the zero-touch portal.
    System.out.println("No zero-touch enrollment account found.");
} else {
    // Print the customers in this page.
    for (Company customer : customers) {
        System.out.format("%s\tcustomers/%d\n",
              customer.getCompanyName(), customer.getCompanyId());
    }
}

.СЕТЬ

CustomersResource.ListRequest accountRequest = service.Customers.List();
accountRequest.PageSize = 100;
CustomerListCustomersResponse accountResponse = accountRequest.Execute();
IList<Company> customers = accountResponse.Customers ?? new List<Company>();
if (customers.Count == 0)
{
    // No accounts found for the user. Confirm the Google Account
    // that authorizes the request can access the zero-touch portal.
    Console.WriteLine("No zero-touch enrollment account found.");
}
foreach (Company customer in customers)
{
    Console.WriteLine("{0}\tcustomers/{1}",
                      customer.CompanyName,
                      customer.CompanyId);
}

Питон

response = service.customers().list(pageSize=100).execute()
if 'customers' not in response:
  # No accounts found for the user. Confirm the Google Account
  # that authorizes the request can access the zero-touch portal.
  print('No zero-touch enrollment account found.')
  response['customers'] = []

for customer in response['customers']:
  print('{0}\tcustomers/{1}'.format(
      customer['companyName'], customer['companyId']))

В вашем приложении вам нужно будет перемещаться по страницам результатов по учетным записям, поскольку в приведенном выше примере печатаются только первые 100 учетных записей. Чтобы узнать, как это сделать, прочтите «Постраничные результаты» .

У организации обычно есть одна учетная запись клиента, но более крупные организации могут использовать отдельные учетные записи клиентов для каждого подразделения. Поскольку ИТ-администратор может быть участником разных учетных записей клиентов, ваше приложение должно помогать пользователям находить и использовать новые учетные записи клиентов. В своем приложении пометьте каждую учетную запись клиента, используя значение companyName .

Пользователи

ИТ-администраторы разрешают запросы API, которые ваше приложение отправляет от их имени. Чтобы авторизовать запросы API, пользователю вашего приложения необходимо сделать следующее:

Свяжите учетную запись Google с их адресом электронной почты.
Присоединитесь к учетной записи клиента, используя тот же адрес электронной почты.
Примите условия обслуживания клиента с автоматической регистрацией.

Чтобы помочь пользователям вашего приложения настроить его, воспользуйтесь нашим руководством для ИТ-администраторов в разделе «Начало работы и связывание учетной записи Google» в собственной документации.

Управление пользователями

ИТ-администраторы управляют пользователями их учетных записей клиентов на портале автоматической регистрации. Пользователи в учетной записи клиента имеют роль владельца или администратора . Обе роли имеют одинаковый доступ к клиентскому API, но владелец может управлять другими пользователями.

Принятие условий обслуживания

Прежде чем пользователи вашего приложения смогут авторизовать вызовы API, им необходимо принять последнюю версию Условий обслуживания. Это происходит, когда ИТ-администраторы впервые используют автоматическую регистрацию или когда мы обновляем Условия обслуживания. Если пользователь не принял последние Условия обслуживания, API возвращает код состояния HTTP 403 Forbidden , а тело ответа содержит TosError .

Портал автоматически предлагает пользователям принять последнюю версию Условий обслуживания при входе в систему. Чтобы просмотреть предлагаемые подходы, которые может включать ваше приложение, прочтите Условия использования Handle в руководстве по интеграции EMM.

Добавьте авторизацию в свое приложение

Каждый запрос, который ваше приложение отправляет в клиентский API, должен включать токен авторизации. Токен также идентифицирует ваше приложение для Google. Поскольку клиентский API получает доступ к пользовательским данным, авторизация должна исходить от владельца данных. Ваше приложение делегирует авторизацию API ИТ-администраторам с помощью протокола OAuth 2.0 .

Инструкции

Мы предоставляем краткие руководства для приложений Java , .NET и Python . Если вы используете другой язык, выполните два шага ниже, чтобы настроить авторизацию для вашего приложения.

Шаг 1. Включите API автоматической регистрации.

Используйте этот мастер , чтобы создать или выбрать проект в консоли разработчиков Google и автоматически включить API. Нажмите «Продолжить» , затем «Перейти к учетным данным» .
Нажмите «Отмена» в разделе «Создать учетные данные».
В верхней части страницы выберите вкладку экрана согласия OAuth . Выберите адрес электронной почты , введите название продукта , если оно еще не задано, и нажмите кнопку «Сохранить» .
Выберите вкладку «Учетные данные» , нажмите кнопку «Создать учетные данные» и выберите идентификатор клиента OAuth .
Выберите тип приложения в зависимости от типа приложения, которое вы создаете.
Установите Имя на имя вашего приложения.
Нажмите Создать .
Нажмите Скачать JSON .
Переместите файл в свой рабочий каталог и переименуйте его client_secret.json .

Шаг 2: установите клиентскую библиотеку

Чтобы установить клиентскую библиотеку для вашего языка:

Перейдите в клиентские библиотеки Google API и выберите свой язык из списка поддерживаемых языков.
Следуйте инструкциям по установке клиентской библиотеки.

Подробнее об авторизации читайте в статье Использование OAuth 2.0 для доступа к API Google .

Области авторизации

Используйте область авторизации API https://www.googleapis.com/auth/androidworkzerotouchemm в своем приложении, чтобы запросить токен доступа OAuth 2.0.

Параметр области управляет набором ресурсов и операций, вызовы которых разрешены маркером доступа. Токены доступа действительны только для набора операций и ресурсов, описанных в области запроса токена. API охватывает все методы и ресурсы с единой областью автоматической регистрации, показанной выше.

Пример области автоматической регистрации, используемой с клиентской библиотекой API Google, см. в кратких руководствах по Java , .NET и Python . Дополнительные сведения об использовании областей API Google см. в статье Использование OAuth 2.0 для доступа к API Google .