Добавление и регистрация приложения

С помощью URL-ссылок на приложение можно открыть доступ к своей работе для других пользователей, как в вашей организации, так и за ее пределами (в зависимости от имеющихся у вас прав). Кроме URL вы также можете указать такие сведения об элементе, как тип приложения, его предназначение, краткое описание, а также добавить файл .zip с кодом, который использовался для создания этого приложения. При добавлении приложения в ArcGIS Online добавляется только ссылка на URL-адрес приложения; ArcGIS Online не хранит сами файлы приложения.

Как разработчик приложения с учетной записью организации, вы можете также зарегистрировать приложение на платформе. Это включает в себя регистрацию приложения OAuth, чтобы участники организации и пользователи за пределами организации могли входить в приложение. Дополнительные сведения см. в разделе Добавление и регистрация приложения с использованием учетных данных разработчика ниже.

Если вам не нужно регистрировать свое приложение, например, при загрузке примера кода, следуйте инструкциям в разделе Добавление приложения по URL ниже.

Подсказка:

Другим способом сделать ваши приложения доступными для участников вашей организации и вне ее является создание приложений с картами и галереи приложений с группами.

Добавить приложение из URL

Выполните следующие действия, чтобы добавить элемент, который использует URL-адрес для доступа к приложению в веб, но который не требует регистрации (такой как пример кода):

Примечание:

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

  1. Убедитесь, что вы выполнили вход, и у вас есть права для создания ресурсов.
  2. На вкладке Мои ресурсы на странице содержания щелкните Новый элемент и выберите Приложение.
  3. Выберите тип приложения:
    • Веб-картография - веб-приложение, созданное с помощью веб-API, например, JavaScript.
    • Настольное – приложение для настольных систем, созданное на настольной платформе, такой как Java или .NET (Microsoft Windows Desktop).
    • Мобильное – доступное для загрузки приложение, созданное с помощью SDK для мобильных устройств, например, iOS или Android.
    • Другое приложение – настольное приложение, скрипт Python или любой тип стандартного приложения, для которого у вас нет подробной информации о его назначении, API, SDK или URL-адресе.
  4. Для мобильного, настольного приложения или веб-картографии введите URL-адрес приложения, например, https://<myServer>/myWebMapApp.
  5. Для настольных приложений щелкните Обзор и выберите файл .zip, в котором хранится приложение.
  6. Щелкните Далее.
  7. Введите заголовок.
  8. Выберите папку в Мои ресурсы, в которой вы хотели бы сохранить данный элемент.
  9. Если для вашей организации настроены категории ресурсов, нажмите Назначить категории и выберите до 20 категорий, что поможет пользователям в поиске элемента.

    Вы также можете начать вводить имя категории, чтобы сузить список категорий.

  10. Дополнительно введите теги, описывающие элемент.

    Разделяйте термины запятыми (например, Федеральная земля считается одним тегом, а Федеральная, земля рассматриваются как два тега).

    По мере ввода, вы можете выбрать любой из предлагаемых тегов; предложения основаны на введенных ранее тегах.

  11. При желании добавьте краткое описание приложения.
  12. Щелкните Сохранить.

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

Настройте сведения об элементе, прикрепите код, если требуется, и опубликуйте приложение, если у вас есть права на публикацию.

Добавление и регистрация приложения с использованием учетных данных разработчика

Как разработчик приложения с учетной записью организации, вы можете добавить и зарегистрировать ваше приложение в платформе, чтобы получить App ID. Используйте App ID в приложении, чтобы анализировать статистику использования и разрешать пользователям входить на платформу с помощью OAuth 2.0, стандартизированной платформы авторизации. Безопасность пользователя – при использовании OAuth 2.0 приложение будет запрашивать у пользователя вход в платформу с помощью страницы входа, размещенной на платформе. Это также позволяет приложению работать с пользовательскими ресурсами, связанными с организацией, а также работать с другими возможностями ArcGIS Online, такими как геокодирование, маршрутизация и геообогащение. Более подробная информация об аутентификации и OAuth 2.0 представлена на странице Esri Developer.

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

Примечание:

Схема встраивания учетных данных пользователя слегка отличается в зависимости от того, разрабатываете вы веб-приложение или локальное приложение. В документации Esri Developer есть описание и примеры кодов для веб и обычных приложений.

Добавление и регистрация приложения со встроенными учетными данными OAuth 2.0

При использовании учетных данных OAuth 2.0 с созданными вами приложениями, токен доступа генерируется динамически при доступе к приложению. Токен доступа действителен максимум в течение 14 дней.

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

  1. Убедитесь, что вы вошли с использованием учетной записи организации и имеете право на создание ресурсов.
  2. Щелкните вкладку Мои ресурсы на странице ресурсов и выберите Новый элемент.
  3. В окне Новый элемент щелкните Учетные данные разработчика.
  4. Первое представленное вам окно будет отличаться в зависимости от ваших прав в организации. Если вы являетесь участником роли, которая не включает право на создание ключей API, перейдите к шагу 5. Если ваша роль включает в себя права на создание ключей API, перейдите к шагу 4.
  5. Выберите параметр Учетные данные OAuth 2.0 и нажмите Далее.
  6. В разделе Перенаправлять URL-адреса укажите URL-адрес веб-страницы или конечной точки сервера, который будет использоваться для перенаправления пользователей после их успешного входа в систему. Нажмите Добавить, чтобы добавить дополнительные URL-адреса перенаправления по мере необходимости.

    URL-адреса перенаправления, указанные при авторизации, должны совпадать с одним из зарегистрированных URL-адресов, в противном случае авторизация будет отклонена.

    Специальное значение urn:ietf:wg:oauth:2.0:oob также может быть указано для предоставления авторизации. Это приводит к тому, что код авторизации доставляется на URL портала (/oauth2/approval). Это значение обычно используется приложениями, у которых нет веб-сервера или пользовательской схемы URL, по которой может быть доставлен код.

    Ниже приведены примеры поддерживаемых форматов URL-адресов перенаправления:

    • https://app.foo.com
    • urn:ietf:wg:oauth:2.0:oob

  7. В разделе Ссылки URL-адресов укажите URL-адрес или IP-адрес, которому разрешено подключение. Нажмите Добавить, чтобы добавить дополнительные ссылки URL-адресов или IP-адреса по мере необходимости.
  8. В Параметры среды приложения выберите параметр среды для приложения — Несколько, Нативное, Браузер или Сервер.
  9. В поле URL введите URL-адрес вашего приложения в формате https://<myServer>/myWebMapApp.
  10. Щелкните Далее.

    Если вы являетесь участником роли с правами назначать права приложениям OAuth 2.0, нажатие кнопки Далее откроет вам окно, в котором вы можете определить, какие действия разрешены приложению. Если у вас нет этих прав, перейдите к шагу 12.

  11. Выберите, какие действия позволят выполнять учетные данные приложению, назначив права, и нажмите Далее.

    Список доступных вам прав доступа будет варьироваться в зависимости от того, есть ли у вас подписка ArcGIS Location Platform и какие права вы имеете в организации. Вы не можете предоставлять права, которыми не обладает ваша учетная запись.

  12. Нажмите Обзор элементов и выберите элементы, для доступа к которым могут использоваться встроенные учетные данные, и нажмите Добавить элементы.

    Или можно щелкнуть Пропустить. Если вы пропустили указание того, к каким элементам имеют доступ пользователи учетных данных OAuth 2.0, учетные данные можно использовать для доступа ко всем элементам, которыми вы владеете.

  13. Введите заголовок.
  14. Выберите папку в Мои ресурсы, в которой вы хотели бы сохранить данный элемент.
  15. Если для вашей организации настроены категории ресурсов, нажмите Назначить категории и выберите до 20 категорий, что поможет пользователям в поиске элемента.

    Вы также можете начать вводить имя категории, чтобы сузить список категорий.

  16. Дополнительно введите теги, описывающие элемент.

    Разделяйте термины запятыми (например, Федеральная земля считается одним тегом, а Федеральная, земля рассматриваются как два тега).

    По мере ввода, вы можете выбрать любой из предлагаемых тегов; предложения основаны на введенных ранее тегах.

  17. При желании добавьте краткое описание приложения.
  18. Щелкните Далее.
  19. Просмотрите краткую информацию об учетных данных. Чтобы изменить настройки, нажмите кнопку Назад, для внесения изменений перед созданием элемента. Если настройки учетных данных верны, щелкните Установить.

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

Вы можете настроить информацию об элементе для приложения.

На вкладке Настройки страницы элемента приложения вы можете просмотреть регистрационную информацию, которая включает идентификатор приложения (Client ID), секрет приложения (Client Secret) и параметры среды приложения. Вы можете обновить URL источника данных или URL адреса перенаправления, сбросить секретный вопрос, отменить регистрацию приложения или копировать или продлить временный токен приложения. Также вы можете изменить права, которые имеет приложение, и указать, к каким слоям оно может иметь доступ.

Примечание:

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

Нажмите Просмотреть применение на вкладке Настройки, чтобы получить доступ к информации о том, кто вошел в приложение, и о количестве израсходованных кредитов.

Добавьте и зарегистрируйте приложение со встроенными учетными данными ключа API.

Используйте учетные данные ключа API при необходимости внедрения учетных данных в приложение с ключом, действующим более 14 дней.

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

  1. Убедитесь, что вы вошли с использованием учетной записи организации и имеете права доступа на создание ресурсов и API ключей.
  2. Щелкните вкладку Мои ресурсы на странице ресурсов и выберите Новый элемент.
  3. В окне Новый элемент щелкните Учетные данные разработчика.
  4. Выберите параметр Учетные данные ключа API и нажмите Далее.
  5. Используйте календарь, чтобы указать дату истечения срока действия учетных данных.

    Срок действия учетных данных может истечь на следующий день (минимум) или через 365 дней (максимум). Срок действия истекает в 23:59. в день, который вы выберете для истечения срока действия. Время сохраняется на основе времени вашего браузера, когда вы добавляете приложение и генерируете учетные данные.

  6. В разделе Ссылки URL-адресов укажите URL-адрес или IP-адрес, которому разрешено подключение к приложению. Нажмите Добавить, чтобы добавить дополнительные ссылки URL-адресов или IP-адреса.

    URL-адреса перенаправления, указанные при авторизации, должны совпадать с одним из зарегистрированных URL-адресов, в противном случае авторизация будет отклонена.

  7. Щелкните Далее.
  8. Выберите, какие действия позволят выполнять учетные данные приложению, назначив права, и нажмите Далее.

    Список доступных вам прав доступа будет варьироваться в зависимости от того, есть ли у вас подписка ArcGIS Location Platform и какие права вы имеете в организации. Вы не можете предоставлять права, которыми не обладает ваша учетная запись.

  9. Нажмите Обзор элементов, выберите элементы, для доступа к которым могут использоваться встроенные учетные данные, и нажмите Добавить элементы.

    Или можно щелкнуть Пропустить. Если вы пропустили указание того, к каким элементам имеют доступ пользователи ключа API, учетные данные можно использовать для доступа ко всем элементам, которыми вы владеете.

  10. Введите заголовок.
  11. Выберите папку в Мои ресурсы, в которой вы хотели бы сохранить данный элемент.
  12. Если для вашей организации настроены категории ресурсов, нажмите Назначить категории и выберите до 20 категорий, что поможет пользователям в поиске элемента.

    Вы также можете начать вводить имя категории, чтобы сузить список категорий.

  13. Дополнительно введите теги, описывающие элемент.

    Разделяйте термины запятыми (например, Федеральная земля считается одним тегом, а Федеральная, земля рассматриваются как два тега).

    По мере ввода, вы можете выбрать любой из предлагаемых тегов; предложения основаны на введенных ранее тегах.

  14. При желании добавьте краткое описание приложения.
  15. Щелкните Далее.
  16. Просмотрите краткую информацию об учетных данных. Чтобы изменить настройки, нажмите кнопку Назад, для внесения изменений перед созданием элемента. Если настройки учетных данных верны, щелкните Установить.

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

Вы можете настроить информацию об элементе для приложения.

На вкладке Настройки страницы элемента приложения вы можете просмотреть регистрационную информацию, которая включает идентификатор приложения (Client ID), секрет приложения (Client Secret) и параметры среды приложения. Вы можете обновить URL-адреса перенаправления, сбросить секретный вопрос, отменить регистрацию приложения или копировать или продлить временный токен приложения. Также вы можете изменить права доступа, которые имеет приложение, и указать, к каким слоям оно может иметь доступ.

Примечание:

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

Нажмите Просмотреть применение на вкладке Настройки, чтобы получить доступ к информации о том, кто вошел в приложение, и о количестве израсходованных кредитов.

Связанные разделы