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

С помощью 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. Выберите папку в Мои ресурсы, в которой вы хотели бы сохранить данный элемент.

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

    Имена папок не могут содержать 4-байтовые символы Unicode.

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

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

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

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

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

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

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

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

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

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

Кроме того, вы можете встроить ключ API в приложение при его регистрации.

Тип учетных данных разработчика, который вы можете включить в приложение, зависит от ваших прав в организации. Если вы являетесь участником с ролью администратора по умолчанию или участником с настраиваемой ролью с правом создания ключей 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 и какие права вы имеете в организации. Вы не можете предоставлять права, которыми не обладает ваша учетная запись.

    Для получения информации о типах прав доступа обратитесь к Руководству по безопасности и аутентификации в справке разработчика Esri.

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

    Или можно щелкнуть Пропустить.

  13. Укажите заголовок.
  14. Выберите папку в Мои ресурсы, в которой вы хотели бы сохранить данный элемент.

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

    Имена папок не могут содержать 4-байтовые символы Unicode.

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

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

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

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

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

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

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

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

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

Примечание:

Раздел Просмотреть использование недоступен при входе по подписке ArcGIS Location Platform.

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

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

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

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

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

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

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

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

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

    • https://www.example.com/pages
    • https://www.example.com/pages/index.html

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

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

    Для получения информации о типах прав доступа обратитесь к Руководству по безопасности и аутентификации в справке разработчика Esri.

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

    Или можно щелкнуть Пропустить.

  10. Укажите заголовок.
  11. Выберите папку в Мои ресурсы, в которой вы хотели бы сохранить данный элемент.

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

    Имена папок не могут содержать 4-байтовые символы Unicode.

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

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

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

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

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

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

    Вы должны скопировать API-ключ, как только он будет сгенерирован.

    • Если вы щелкнули опцию Создать ключ API и перейти на страницу подробной информации об элементе. Я готов скопировать и сохранить ключ., откроется всплывающее окно Сгенерировать API-ключ при нажатии кнопки Далее. Щелкните кнопку Копировать, чтобы скопировать ключ. Вставьте ключ в защищенный документ. Закройте всплывающее окно, когда закончите.
    • Если вы щелкнули опцию Перейти на страницу подробной информации об элементе. Я сгенерирую API-ключ позже., откроется страница элемента учетных данных. Страница элемента откроется, когда вы щелкните Далее. Вы можете сгенерировать API-ключ на вкладке Настройки на странице элемента.

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

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

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

Примечание:

Раздел Просмотреть использование недоступен при входе по подписке ArcGIS Location Platform.

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

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