С помощью URL-ссылок на приложение можно открыть доступ к своей работе для других пользователей, как в вашей организации, так и за ее пределами (в зависимости от имеющихся у вас прав). Кроме URL вы также можете указать такие сведения об элементе, как тип приложения, его предназначение, краткое описание, а также добавить файл .zip с кодом, который использовался для создания этого приложения. При добавлении приложения в ArcGIS Online добавляется только ссылка на URL-адрес приложения; ArcGIS Online не хранит сами файлы приложения.
Как разработчик приложения с учетной записью организации, вы можете также зарегистрировать приложение на платформе. Это включает в себя регистрацию приложения OAuth, чтобы участники организации и пользователи за пределами организации могли входить в приложение. Дополнительные сведения см. в разделе Добавление и регистрация приложения с использованием учетных данных разработчика ниже.
Если вам не нужно регистрировать свое приложение, например, при загрузке примера кода, следуйте инструкциям в разделе Добавление приложения по URL ниже.
Подсказка:
Другим способом сделать ваши приложения доступными для участников вашей организации и вне ее является создание приложений с картами и галереи приложений с группами.
Добавить приложение из URL
Выполните следующие действия, чтобы добавить элемент, который использует URL-адрес для доступа к приложению в веб, но который не требует регистрации (такой как пример кода):
Примечание:
Чтобы добавить зарегистрированное приложение, выполните действия по добавлению и регистрации приложения, используя учетные данные разработчика.
- Убедитесь, что вы выполнили вход, и у вас есть права для создания, обновления и удаления ресурсов.
- На вкладке Мои ресурсы на странице содержания щелкните Новый элемент и выберите Приложение.
- Выберите тип приложения:
- Веб-картография - веб-приложение, созданное с помощью веб-API, например, JavaScript.
- Настольное – приложение для настольных систем, созданное на настольной платформе, такой как Java или .NET (Microsoft Windows Desktop).
- Мобильное – доступное для загрузки приложение, созданное с помощью SDK для мобильных устройств, например, iOS или Android.
- Другое приложение – настольное приложение, скрипт Python или любой тип стандартного приложения, для которого у вас нет подробной информации о его назначении, API, SDK или URL-адресе.
- Для мобильного, настольного приложения или веб-картографии введите URL-адрес приложения, например, https://<myServer>/myWebMapApp.
- Для настольных приложений щелкните Обзор и выберите файл .zip, в котором хранится приложение.
- Щелкните Далее.
- Укажите заголовок.
- Выберите папку в Мои ресурсы, в которой вы хотели бы сохранить данный элемент.
Кроме того, можно выбрать в меню пункт Создать новую папку и ввести имя папки, чтобы сохранить этот элемент в новой папке.
Имена папок не могут содержать 4-байтовые символы Unicode.
- Если для вашей организации настроены категории ресурсов, нажмите Назначить категории и выберите до 20 категорий, что поможет пользователям в поиске элемента.
Вы также можете начать вводить имя категории, чтобы сузить список категорий.
- Дополнительно введите теги, описывающие элемент.
Разделяйте термины запятыми (например Федеральная земля считается одним тегом, а Федеральная, земля рассматривается как два тега).
По мере ввода вы можете выбирать любые из появляющихся тегов; предлагаемые теги создаются на основе ранее добавленных вами тегов.
- При желании добавьте краткое описание приложения.
- Щелкните Сохранить.
Как только вы добавите приложение, оно появится в ваших ресурсах. Если вам необходимо зарегистрировать его позже, вы можете сделать это на вкладке Настройки страницы элементов приложения. Дополнительные сведения см. в разделе Добавление и регистрация приложения с использованием учетных данных разработчика ниже.
Настройте сведения об элементе, прикрепите код, если требуется, и опубликуйте приложение, если у вас есть права на публикацию.
Добавление и регистрация приложения с использованием учетных данных разработчика
Как разработчик приложения с учетной записью организации, вы можете добавить и зарегистрировать ваше приложение в платформе, чтобы получить 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.
- Убедитесь, что вы вошли с использованием учетной записи организации с правами на создание, обновление и удаление ресурсов.
- Щелкните вкладку Мои ресурсы на странице ресурсов и выберите Новый элемент.
- В окне Новый элемент щелкните Учетные данные разработчика.
- Выберите параметр Учетные данные OAuth 2.0 и нажмите Далее.
- В разделе Перенаправлять 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
- В разделе Ссылки URL-адресов укажите URL-адрес или IP-адрес, которому разрешено подключение. Нажмите Добавить, чтобы добавить дополнительные ссылки URL-адресов или IP-адреса по мере необходимости.
- В Параметры среды приложения выберите параметр среды для приложения — Несколько, Нативное, Браузер или Сервер.
- В поле URL введите URL-адрес вашего приложения в формате https://<myServer>/myWebMapApp.
- Щелкните Далее.
Если вы являетесь участником роли с правами назначать права приложениям OAuth 2.0, нажатие кнопки Далее откроет вам окно, в котором вы можете определить, какие действия разрешены приложению. Если у вас нет этих прав, перейдите к шагу 12.
- Выберите, какие действия позволят выполнять учетные данные приложению, назначив права, и нажмите Далее.
Список доступных вам прав доступа будет варьироваться в зависимости от того, есть ли у вас подписка ArcGIS Location Platform и какие права вы имеете в организации. Вы не можете предоставлять права, которыми не обладает ваша учетная запись.
Для получения информации о типах прав доступа обратитесь к Руководству по безопасности и аутентификации в справке разработчика Esri.
- Нажмите Обзор элементов и выберите элементы, для доступа к которым могут использоваться встроенные учетные данные, и нажмите Добавить элементы.
Или можно щелкнуть Пропустить.
- Укажите заголовок.
- Выберите папку в Мои ресурсы, в которой вы хотели бы сохранить данный элемент.
Кроме того, можно выбрать в меню пункт Создать новую папку и ввести имя папки, чтобы сохранить этот элемент в новой папке.
Имена папок не могут содержать 4-байтовые символы Unicode.
- Если для вашей организации настроены категории ресурсов, нажмите Назначить категории и выберите до 20 категорий, что поможет пользователям в поиске элемента.
Вы также можете начать вводить имя категории, чтобы сузить список категорий.
- Дополнительно введите теги, описывающие элемент.
Разделяйте термины запятыми (например Федеральная земля считается одним тегом, а Федеральная, земля рассматривается как два тега).
По мере ввода вы можете выбирать любые из появляющихся тегов; предлагаемые теги создаются на основе ранее добавленных вами тегов.
- При желании добавьте краткое описание приложения.
- Щелкните Далее.
- Просмотрите краткую информацию об учетных данных. Чтобы изменить настройки, нажмите кнопку Назад для внесения изменений перед созданием элемента.
- Если вы предоставили персональные права доступа для учетных данных, установите флажок рядом с подтверждением безопасности, чтобы подтвердить, что вы прочитали и согласны с ним, и щелкните Создать, чтобы создать учетные данные.
Приложение будет добавлено к вашим ресурсам, и появится страница с его элементами. Значок , указывающий на то, что учетные данные OAuth 2.0 используются в приложении, отображается на странице элемента, а также при просмотре элемента на странице содержания или на панелях предварительного просмотра элемента. На вкладке Обзор страницы элемента значок указывает, включены ли в учетные данные персональные права доступа или в них включены только стандартные права.
Вы можете настроить информацию об элементе для приложения.
Нажмите Просмотреть применение на вкладке Настройки, чтобы получить доступ к информации о том, кто вошел в приложение, и о количестве израсходованных кредитов.
Примечание:
Раздел Просмотреть использование недоступен при входе по подписке ArcGIS Location Platform.
Вы также можете управлять настройками учетных данных, встроенных в приложение.
Добавьте и зарегистрируйте приложение со встроенными учетными данными ключа API.
Используйте учетные данные ключа API при необходимости внедрения учетных данных в приложение с ключом, действующим более 14 дней.
Выполните следующие действия, чтобы добавить приложение и создать встроенный в него ключ API для использования в целях аутентификации.
- Убедитесь, что вы вошли с использованием учетной записи организации с правами на создание ключей API, а также на создание, обновление и удаление ресурсов.
- Щелкните вкладку Мои ресурсы на странице ресурсов и выберите Новый элемент.
- В окне Новый элемент щелкните Учетные данные разработчика.
- Выберите параметр Учетные данные ключа API и нажмите Далее.
- Используйте календарь, чтобы указать дату истечения срока действия учетных данных.
Срок действия учетных данных может истечь на следующий день (минимум) или через 365 дней (максимум). Срок действия истекает в 23:59. в день, который вы выберете для истечения срока действия. Время сохраняется на основе времени вашего браузера, когда вы добавляете приложение и генерируете учетные данные.
- В разделе Ссылки URL-адресов укажите URL-адрес или IP-адрес, которому разрешено подключение к приложению. Нажмите Добавить, чтобы добавить дополнительные ссылки URL-адресов или IP-адреса.
URL-адреса, указанные при авторизации, должны совпадать с одним из зарегистрированных URL-адресов, в противном случае авторизация будет отклонена.
Ниже приведены примеры поддерживаемых форматов URL-адресов запросов:
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- Щелкните Далее.
- Выберите, какие действия позволят выполнять учетные данные приложению, назначив права, и нажмите Далее.
Список доступных вам прав доступа будет варьироваться в зависимости от того, есть ли у вас подписка ArcGIS Location Platform и какие права вы имеете в организации. Вы не можете предоставлять права, которыми не обладает ваша учетная запись.
Для получения информации о типах прав доступа обратитесь к Руководству по безопасности и аутентификации в справке разработчика Esri.
- Нажмите Обзор элементов, выберите элементы, для доступа к которым могут использоваться встроенные учетные данные, и нажмите Добавить элементы.
Или можно щелкнуть Пропустить.
- Укажите заголовок.
- Выберите папку в Мои ресурсы, в которой вы хотели бы сохранить данный элемент.
Кроме того, можно выбрать в меню пункт Создать новую папку и ввести имя папки, чтобы сохранить этот элемент в новой папке.
Имена папок не могут содержать 4-байтовые символы Unicode.
- Если для вашей организации настроены категории ресурсов, нажмите Назначить категории и выберите до 20 категорий, что поможет пользователям в поиске элемента.
Вы также можете начать вводить имя категории, чтобы сузить список категорий.
- Дополнительно введите теги, описывающие элемент.
Разделяйте термины запятыми (например Федеральная земля считается одним тегом, а Федеральная, земля рассматривается как два тега).
По мере ввода вы можете выбирать любые из появляющихся тегов; предлагаемые теги создаются на основе ранее добавленных вами тегов.
- При желании добавьте краткое описание приложения.
- Щелкните Далее.
- Просмотрите краткую информацию об учетных данных. Чтобы изменить настройки, нажмите кнопку Назад для внесения изменений перед созданием элемента.
- Если вы предоставили персональные права доступа для учетных данных, установите флажок рядом с подтверждением безопасности, чтобы подтвердить, что вы прочитали и согласны с ним, и щелкните Далее.
- Выберите, следует ли сгенерировать API-ключ немедленно или позже, и щелкните Далее.
Вы должны скопировать API-ключ, как только он будет сгенерирован.
- Если вы щелкнули опцию Создать ключ API и перейти на страницу подробной информации об элементе. Я готов скопировать и сохранить ключ., откроется всплывающее окно Сгенерировать API-ключ при нажатии кнопки Далее. Щелкните кнопку Копировать, чтобы скопировать ключ. Вставьте ключ в защищенный документ. Закройте всплывающее окно, когда закончите.
- Если вы щелкнули опцию Перейти на страницу подробной информации об элементе. Я сгенерирую API-ключ позже., откроется страница элемента учетных данных. Страница элемента откроется, когда вы щелкните Далее. Вы можете сгенерировать API-ключ на вкладке Настройки на странице элемента.
Приложение будет добавлено к вашим ресурсам, и появится страница с его элементами. Значок , указывающий на то, что ключ API встроен в приложение, отображается на странице элемента, а также при просмотре элемента на странице содержания или на панелях предварительного просмотра элемента. На вкладке Обзор на странице элемента есть значок, который показывает, включены ли в учетные данные персональные права доступа или в них включены только стандартные права.
Вы можете настроить информацию об элементе для приложения.
Нажмите Просмотреть применение на вкладке Настройки, чтобы получить доступ к информации о том, кто вошел в приложение, и о количестве израсходованных кредитов.
Примечание:
Раздел Просмотреть использование недоступен при входе по подписке ArcGIS Location Platform.
Вы также можете управлять настройками учетных данных, встроенных в приложение.