Использование аутентификации

ArcGIS Velocity требуется доступ к ArcGIS Online для создания элементов (например, каналов и аналитики), запуска элементов (например, канала из векторного слоя) и записи объектов в выходные векторные слои. Вместо хранения имени пользователя и пароля Velocity использует токен обновления или ключ ArcGIS API для аутентификации и подключения к ArcGIS Online.

Вы можете зарегистрировать в Velocity как ключ ArcGIS API, так и токен обновления в системе. В таких ситуациях Velocity будет использовать ключ ArcGIS API вместо токена обновления. Если срок действия ключа ArcGIS API истечет или он станет недействительным, Velocity будет предпринята попытка переключиться на токен обновления для создания и запуска элементов.

Механизмы аутентификации

В следующих разделах объясняется, как работают оба метода аутентификации и как Velocity их использует.

Токен обновления

Токены обновления — это кратковременные токены доступа со стандартным сроком действия, равным двум неделям. Для обеспечения более длительной работы каналов и аналитики в Velocity предусмотрены механизмы, позволяющие определять приближение истечения срока действия токенов обновления. Velocity автоматически запрашивает и обновляет эти токены.

Подробнее о том, как создается токен обновления

Ключ ArcGIS API

Ключи API ArcGIS — это токены доступа с более длительным сроком действия: от одного дня до одного года. Срок действия ключа ArcGIS API определяется при его создании. Рекомендуется задавать срок действия в один год. Ваша учетная запись пользователя ArcGIS Online должна обладать необходимыми для создания ключа ArcGIS API правами.

Более подробно о советах и ограничениях использования ключа ArcGIS API

Создание ключа API в ArcGIS Online

Примечание:

Сначала необходимо создать ключ API в ArcGIS Online, а затем зарегистрировать ключ ArcGIS API в Velocity.

Чтобы создать ключ API, выполните следующие действия:

1. В браузере откройте ArcGIS Online и выполните вход, используя свои учетные данные организации ArcGIS.
2. На вашем портале нажмите Ресурсы > Мои ресурсы > Новый элемент.

   

3. Щелкните Учетные данные разработчика > Учетные данные ключа API и нажмите Далее.

   

4. Выберите опцию Частное приложение, имитирующее вас и нажмите Далее.

   

5. В окне Создать учетные данные разработчика выполните следующие действия:
   1. Нажмите на параметр Срок действия (обязательно) и задайте срок действия ключа API.

      Примечание:

      Минимальный срок действия один день, максимальный — один год. Рекомендуется задавать срок действия в один год.

   2. Укажите значения параметра URL-адреса ссылок и щелкните Далее.

      Введите значение URL-адресов ссылок https://*.arcgis.com.

      

   3. В разделе Сведения об элементе укажите значение параметра Заголовок, чтобы присвоить элементу ключа API имя, и щелкните Далее.

      

   4. Поставьте отметку Я подтверждаю и принимаю возможности выбранных прав доступа и нажмите Далее.

      

   5. Выберите вариант генерации ключа API и нажмите Далее.

      Доступны следующие опции:

      • Создайте новый ключ API сейчас. Я готов копировать и сохранить ключ.
      • Перейти на страницу подробной информации об элементе. Я создам ключ API позднее.

      

6. На странице Создать ключ API, скопируйте сгенерированный ключ API и нажмите Закрыть.

   Примечание:

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

   

7. На странице сведений об элементе перейдите в раздел Настройки > Общие, чтобы открыть страницу Общие.

   Рекомендуется включить переключатель Управление удалением, чтобы предотвратить случайное удаление этого элемента.

   

8. На странице Общие наведите курсор на текст Окончание срока действия, чтобы просмотреть полную дату истечения срока действия ключа API.

   Возвращаемое значение показывается в вашем местном часовом поясе.

   

После выполнения описанных выше действий вы создали в ArcGIS Online ключ API, который можете зарегистрировать в Velocity.

Подробнее о создании учетных данных ключа API в ArcGIS Online

Регистрация ключа ArcGIS API в Velocity

После создания ключа API в ArcGIS Online вы можете зарегистрировать его в Velocity.

Чтобы зарегистрировать ключ ArcGIS API в Velocity, выполните следующие действия:

1. В браузере откройте Velocity и выполните вход, используя свои учетные данные организации ArcGIS.
2. Нажмите на кнопку Просмотреть механизм аутентификации , чтобы развернуть ниспадающее меню Механизм аутентификации.

   

3. Щелкните Обновить механизм аутентификации, чтобы открыть диалоговое окно Настроить механизм аутентификации.
4. Выберите опцию Ключ ArcGIS API и щелкните Далее.

   

5. Вставьте ключ API, созданный вами в предыдущем разделе, в текстовое поле Ключ ArcGIS API.
6. Задайте для опции Дата окончания срока действия тот же день, который вы выбрали в предыдущем разделе.
7. Щелкните Подтвердить.

   

   После выполнения описанных выше действий вы получите сообщение об успехе. Обратите внимание, что переключатель Зарегистрированный ключ ArcGIS API Key включен в ниспадающем меню Механизм аутентификации, что указывает на то, что у вас зарегистрирован ключ ArcGIS API.

   

   Подробнее о регистрации и создании ключей ArcGIS API

Советы и ограничения

При использовании ключей ArcGIS API в Velocity учитывайте следующее:

• В настоящее время уведомления по электронной почте о приближении даты истечения срока действия зарегистрированного ключа ArcGIS API Velocity не отправляются.

• Если в учетной записи ArcGIS Online отсутствует опция Учетные данные ключа API в меню Создать учетные данные разработчика, возможно, у вашей учетной записи нет необходимых прав. Для создания и назначения авторизации учетным данным ключа API ваша учетная запись должна обладать необходимыми правами.

  Вы можете изменить общие права доступа на странице Роли участников. Чтобы открыть страницу Роли участников, выберите Организация > Настройки > Роли участников.

  В разделе Управление ролями, в подразделе Роли участников, вы можете просмотреть все существующие роли в ArcGIS Online. Нажмите на кнопку дополнительных опций рядом с ролью и выберите опцию Редактировать, чтобы открыть окно Редактировать роль.

  

  В окне Редактировать роль разверните раздел Общие права доступа > Ресурс и включите переключатели Создать ключи API и Назначать права доступа приложениям OAuth 2.0, чтобы создать и назначить авторизацию для учетных данных ключа API.

  

  Примечание:

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

• У учетной записи пользователя должен быть доступ к элементам Velocity для использования ключа API, созданного этим пользователем в Velocity.