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