Dodanie odnośnika URL do istniejącej aplikacji jest prostym i szybkim sposobem na udostępnienie swoich prac członkom instytucji i publicznie (zależnie od posiadanych uprawnień do udostępniania). Oprócz samego adresu URL można udostępnić także inne szczegóły, takie jak typ aplikacji, jej przeznaczenie, podsumowanie i opis, a także plik .zip z kodem użytym do jej utworzenia. Dodanie aplikacji do zasobów usługi ArcGIS Online polega tylko na dodaniu odnośnika do adresu URL. Pliki aplikacji nie są przechowywane w usłudze ArcGIS Online.
Twórca aplikacji z kontem instytucji może również zarejestrować aplikację na platformie. Obejmuje to rejestrację aplikacji OAuth, dzięki czemu członkowie instytucji i użytkownicy spoza niej mogą logować się do aplikacji. Więcej informacji zawiera poniższa sekcja Dodawanie i rejestrowanie aplikacji z użyciem poświadczeń programisty.
Jeśli nie musisz rejestrować swojej aplikacji — na przykład przy przesyłaniu próbki kodu — wykonaj czynności przedstawione w poniższej sekcji Dodawanie aplikacji z użyciem adresu URL.
Wskazówka:
Kolejnym sposobem na udostępnienie aplikacji członkom instytucji i publicznie jest utworzenie aplikacji przy użyciu mapy lub aplikacji galerii za pomocą grup.
Dodawanie aplikacji z użyciem adresu URL
Wykonaj następujące czynności, aby dodać element, który używa adresu URL do uzyskania dostępu do aplikacji w sieci, ale nie wymaga zarejestrowania (na przykład przykłady kodu):
Notatka:
Aby dodać zarejestrowaną aplikację, wykonaj następujące czynności w celu dodania i zarejestrowania aplikacji z użyciem poświadczeń programisty.
- Sprawdź, czy jesteś użytkownikiem zalogowanym w instytucji i masz uprawnienia do tworzenia, aktualizacji i usuwania zasobów.
- Na karcie Moje zasoby strony zasobów kliknij opcję Nowy element, a następnie kliknij opcję Aplikacja.
- Wybierz typ aplikacji:
- Mapa internetowa — aplikacja internetowa opracowana na podstawie interfejsu sieciowego API, takiego jak JavaScript.
- Aplikacja komputerowa — aplikacja na komputery zbudowana na odpowiedniej platformie, takiej jak Java lub .NET (komputer z systemem Microsoft Windows).
- Aplikacja mobilna — dostępna do pobrania aplikacja na urządzenia mobilne zbudowana przy użyciu zestawu narzędzi SDK, np. dla systemu iOS lub Android.
- Inna aplikacja — aplikacja komputerowa, skrypt Python lub dowolnego typu aplikacja ogólna bez podanych szczegółów dotyczących przeznaczenia, interfejsów API, zestawów narzędzi SDK, czy adresów URL.
- W przypadku mapy internetowej, aplikacji komputerowej lub aplikacji mobilnej wpisz adres URL aplikacji, na przykład: https://<myServer>/myWebMapApp.
- W przypadku aplikacji komputerowej kliknij opcję Przeglądaj i wybierz plik .zip, który zawiera aplikację.
- Kliknij przycisk Dalej.
- Podaj tytuł.
- Na stronie Moje zasoby wybierz folder, w którym chcesz zapisać element.
Alternatywnie możesz wybrać z menu opcję Utwórz nowy folder i wpisać nazwę folderu, aby zapisać element w nowym folderze.
Nazwy folderów nie mogą zawierać 4-bajtowych znaków Unicode.
- Jeśli w instytucji są skonfigurowane kategorie zasobów, kliknij opcję Przypisz kategorie i wybierz maksymalnie 20 kategorii pomocnych w wyszukaniu tego elementu.
Aby zawęzić listę kategorii, możesz też zacząć wpisywać nazwę kategorii.
- Opcjonalnie wpisz znaczniki opisujące element.
Oddziel wyrażenia przecinkami (na przykład wyrażenie Obszar federalny jest traktowane jako pojedynczy znacznik, a wyrażenie obszar, federalny jest interpretowane jako dwa znaczniki).
Podczas wpisywania możesz wybrać dowolne z proponowanych znaczników. Propozycje są generowane na podstawie wcześniej dodanych znaczników.
- Opcjonalnie dodaj podsumowanie zawierające opis aplikacji.
- Kliknij przycisk Zapisz.
Po dodaniu aplikacji jest ona wyświetlana w zasobach użytkownika. Jeśli będzie potrzebne jej późniejsze zarejestrowanie, można to zrobić na karcie Ustawienia strony elementu aplikacji. Więcej informacji zawiera poniższa sekcja Dodawanie i rejestrowanie aplikacji z użyciem poświadczeń programisty.
Jeśli jest to wymagane, można skonfigurować szczegóły elementu, dołączyć kod oraz udostępnić aplikację (potrzebne są uprawnienia do udostępniania).
Tworzenie elementów poświadczeń programisty
Programista dysponujący kontem instytucji może utworzyć element poświadczeń programisty w celu wygenerowania identyfikatora aplikacji. Aby uzyskać statystyki wykorzystania oraz umożliwić użytkownikom rejestrację na platformie z protokołem OAuth 2.0 będącym standaryzowanym schematem przeprowadzania weryfikacji, należy użyć identyfikatora aplikacji. Wraz z protokołem OAuth 2.0 aplikacje kierują użytkownika, by rejestrował się na platformie poprzez hostowaną na platformie stronę logowania. Aplikacja może także współdziałać z zasobami użytkowników skojarzonymi z ich instytucją, jak również pracować z wykorzystaniem innych funkcji dostępnych w usłudze ArcGIS Online, takich jak geokodowanie, wyznaczanie tras i GeoEnrichment. Aby dowiedzieć się więcej o uwierzytelnianiu i standardzie OAuth 2.0, przejdź na stronę Esri Developer.
Można również utworzyć poświadczenia programisty do uwierzytelniania aplikacji i generowania kluczy API.
Typ tworzonych poświadczeń programisty zależy od uprawnień użytkownika w instytucji. Członek o przypisanej domyślnej roli administratora lub członek o roli niestandardowej z uprawnieniami do generowania kluczy API może używać poświadczeń OAuth 2.0 lub poświadczeń wykorzystujących klucz interfejsu API. W przeciwnym razie można używać tylko poświadczeń programisty OAuth 2.0
Po utworzeniu poświadczeń programisty kliknij opcję Wyświetl użycie na karcie Ustawienia strony elementy aplikacji, aby uzyskać dostęp do informacji o tym, kto zalogował się do aplikacji i ile kredytów wykorzystał. Możesz także zarządzać ustawieniami poświadczeń osadzonych w aplikacji.
Notatka:
Sekcja Wyświetl użycie nie jest dostępna po zalogowaniu się za pośrednictwem subskrypcji ArcGIS Location Platform.
Scenariusz wdrażania metody logowania użytkowników różni się nieznacznie w zależności od tego, czy tworzona jest aplikacja internetowa czy natywna. Dokumentacja platformy Esri Developer zawiera pełne opisy oraz próbki kodu dla aplikacji internetowych i natywnych.
Tworzenie poświadczeń OAuth 2.0 do uwierzytelniania użytkownika
Wykonaj poniższe czynności, jeśli aplikacja wymaga od użytkowników logowania się przy użyciu konta usługi ArcGIS Online.
- Sprawdź, czy jesteś użytkownikiem zalogowanym na konto instytucji, które ma uprawnienia do tworzenia, aktualizowania i usuwania zasobów.
- Na stronie zasobów kliknij kartę Moje zasoby i kliknij opcję Nowy element.
- W oknie Nowy element kliknij opcję Poświadczenia programisty.
Pierwsze wyświetlone okno będzie się różnić w zależności od uprawnień użytkownika w instytucji. Jeśli jesteś członkiem pełniącym rolę, która nie obejmuje uprawnienia do tworzenia kluczy API, przejdź do etapu 5. Jeśli Twoja rola obejmuje uprawnienia do tworzenia kluczy API, przejdź do etapu 4.
- Wybierz opcję Poświadczenia OAuth 2.0 do uwierzytelniania użytkownika i kliknij przycisk Dalej.
- W obszarze Adresy URL przekierowania wpisz adres URL strony internetowej lub punktu końcowego serwera używanych do przekierowania użytkowników, gdy się pomyślnie zalogują. Aby dodać więcej adresów URL przekierowania, kliknij przycisk Dodaj.
Adresy URL przekierowania podane podczas autoryzacji muszą być zgodne z jednym z zarejestrowanych adresów URL, w przeciwnym razie autoryzacja zostanie odrzucona.
Jako autoryzację można również podać wartość specjalną urn:ietf:wg:oauth:2.0:oob. W wyniku tego kod autoryzacji zostanie dostarczony na adres URL portalu (/oauth2/approval). Wartość ta jest zwykle używana przez aplikacje, które nie mają serwera internetowego lub schematu niestandardowego adresu URL do dostarczenia kodu.
Poniżej wymieniono przykłady obsługiwanych formatów adresów URL przekierowania:
- https://app.foo.com
- urn:ietf:wg:oauth:2.0:oob
- W polu Adres URL wpisz adresu URL aplikacji w formacie https://<myServer>/myWebMapApp.
- Kliknij przycisk Dalej.
- Podaj tytuł.
- Na stronie Moje zasoby wybierz folder, w którym chcesz zapisać element.
Alternatywnie możesz wybrać z menu opcję Utwórz nowy folder i wpisać nazwę folderu, aby zapisać element w nowym folderze.
Nazwy folderów nie mogą zawierać 4-bajtowych znaków Unicode.
- Jeśli w instytucji są skonfigurowane kategorie zasobów, kliknij opcję Przypisz kategorie i wybierz maksymalnie 20 kategorii pomocnych w wyszukaniu tego elementu.
Aby zawęzić listę kategorii, możesz też zacząć wpisywać nazwę kategorii.
- Opcjonalnie wpisz znaczniki opisujące element.
Oddziel wyrażenia przecinkami (na przykład wyrażenie Obszar federalny jest traktowane jako pojedynczy znacznik, a wyrażenie obszar, federalny jest interpretowane jako dwa znaczniki).
Podczas wpisywania możesz wybrać dowolne z proponowanych znaczników. Propozycje są generowane na podstawie wcześniej dodanych znaczników.
- Opcjonalnie dodaj podsumowanie zawierające opis aplikacji.
- Kliknij przycisk Dalej.
Zostanie wyświetlone podsumowanie poświadczeń.
- Przejrzyj podsumowanie poświadczeń. Aby zmienić ustawienia, kliknij przycisk Wstecz w celu wprowadzenia zmian przed utworzeniem elementu.
- Kliknij przycisk Utwórz.
Aplikacja zostanie dodana do zasobów i pojawi się jej strona elementu. Oznaczenie 
wskazujące, że poświadczenia OAuth 2.0 są używane z aplikacją, pojawia się na stronie elementu, a także wtedy, gdy element jest wyświetlany na stronie zasobów lub na panelach podglądu elementu. Na karcie Informacje ogólne na stronie elementu plakietka wskazuje, czy w poświadczeniach uwzględniane są uprawnienia osobiste, czy tylko uprawnienia standardowe.
Tworzenie poświadczeń OAuth 2.0 do uwierzytelniania aplikacji
Wykonaj poniższe czynności, jeśli publiczna aplikacja nie wymaga od użytkowników logowania się ani generowania tokenów dostępu po stronie serwera.
- Sprawdź, czy jesteś użytkownikiem zalogowanym na konto instytucji, które ma uprawnienia do tworzenia, aktualizowania i usuwania zasobów.
- Na stronie zasobów kliknij kartę Moje zasoby i kliknij opcję Nowy element.
- W oknie Nowy element kliknij opcję Poświadczenia programisty.
Pierwsze wyświetlone okno będzie się różnić w zależności od uprawnień użytkownika w instytucji. Jeśli jesteś członkiem pełniącym rolę, która nie obejmuje uprawnienia do tworzenia kluczy API, przejdź do etapu 5. Jeśli Twoja rola obejmuje uprawnienia do tworzenia kluczy API, przejdź do etapu 4.
- Wybierz opcję Poświadczenia OAuth 2.0 do uwierzytelniania aplikacji i kliknij przycisk Dalej.
- W sekcji Gdzie będą używane te poświadczenia wybierz jedną z następujących opcji:
- Aplikacja prywatna z wybranymi uprawnieniami i dostępem — wybierz tę opcję, aby przyznać dostęp do dowolnego zestawu elementów i uprawnień. Możesz je osadzić w prywatnej aplikacji lub komponencie po stronie serwera używanym przez aplikację publiczną.
- Aplikacja prywatna działająca w Twoim imieniu — wybierz tę opcję, aby przyznać wszystkie Twoje obecne uprawnienia oraz dostęp do zasobów, członków i ustawień instytucji.
- Kliknij przycisk Dalej.
- Opcjonalnie, jeśli wybrano opcję Aplikacja prywatna z wybranymi uprawnieniami i dostępem, wybierz jedną z następujących opcji:
- Brak dostępu do elementów — to poświadczenie wymaga braku dostępu do elementów. Kliknij przycisk Dalej.
- Przyznaj dostęp do elementów za pomocą uprawnień — wybierz uprawnienia, które są wymagane, aby umożliwić dostęp do elementów dla tego poświadczenia. Kliknij przycisk Dalej.
- Przyznaj dostęp do określonych elementów — aby przyznać dostęp, należy najpierw wybrać elementy należące do bieżącego użytkownika. Kliknij przycisk Dalej.
- Opcjonalnie, jeśli wybrano opcję Aplikacja prywatna z wybranymi uprawnieniami i dostępem, wybierz działania, na których wykonywanie zezwolą poświadczenia aplikacji, przez przypisanie odpowiednich uprawnień. Kliknij przycisk Dalej.
Lista dostępnych uprawnień różni się w zależności od tego, czy masz subskrypcję ArcGIS Location Platform i jakie masz uprawnienia w instytucji. Nie możesz nadawać uprawnień, których nie ma Twoje konto.
Informacje na temat typów uprawnień można znaleźć w podręczniku bezpieczeństwa i uwierzytelniania w pomocy firmy Esri dla deweloperów.
- Kliknij przycisk Dalej.
- W sekcji Adresy URL odniesień podaj adres URL lub adres IP, z którego można się łączyć z aplikacją. Kliknij Dodaj, aby dodać więcej odnośnych adresów URL lub adresów IP.
Adresy URL podane podczas autoryzacji muszą być zgodne z jednym z zarejestrowanych adresów URL, w przeciwnym razie autoryzacja jest odrzucana.
Poniżej wymieniono przykłady obsługiwanych formatów adresów URL odniesienia:
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- Kliknij przycisk Dalej.
- Podaj tytuł.
- Na stronie Moje zasoby wybierz folder, w którym chcesz zapisać element.
Alternatywnie możesz wybrać z menu opcję Utwórz nowy folder i wpisać nazwę folderu, aby zapisać element w nowym folderze.
Nazwy folderów nie mogą zawierać 4-bajtowych znaków Unicode.
- Jeśli w instytucji są skonfigurowane kategorie zasobów, kliknij opcję Przypisz kategorie i wybierz maksymalnie 20 kategorii pomocnych w wyszukaniu tego elementu.
Aby zawęzić listę kategorii, możesz też zacząć wpisywać nazwę kategorii.
- Opcjonalnie wpisz znaczniki opisujące element.
Oddziel wyrażenia przecinkami (na przykład wyrażenie Obszar federalny jest traktowane jako pojedynczy znacznik, a wyrażenie obszar, federalny jest interpretowane jako dwa znaczniki).
Podczas wpisywania możesz wybrać dowolne z proponowanych znaczników. Propozycje są generowane na podstawie wcześniej dodanych znaczników.
- Opcjonalnie dodaj podsumowanie zawierające opis aplikacji.
- Kliknij przycisk Dalej.
Zostanie wyświetlone podsumowanie poświadczeń.
- Przejrzyj podsumowanie poświadczeń. Aby zmienić ustawienia, kliknij przycisk Wstecz w celu wprowadzenia zmian przed utworzeniem elementu.
- Jeśli wybrano opcję Aplikacja prywatna działająca w Twoim imieniu, kliknij pole wyboru obok opcji Przyjmuję do wiadomości i akceptuję wymogi bezpieczeństwa powiązane z wybranymi uprawnieniami.
- Kliknij przycisk Utwórz.
Aplikacja zostanie dodana do zasobów i pojawi się jej strona elementu. Oznaczenie wskazujące poświadczenia OAuth 2.0 pojawia się, gdy element jest wyświetlany na stronie zasobów lub na panelach podglądu elementu. Na karcie Informacje ogólne strony elementu oznaczenie Poświadczenia OAuth 2.0 – Działa w imieniu właściciela elementu pojawia się, jeśli w sekcji Gdzie będą używane te poświadczenia wybrano opcję Aplikacja prywatna działająca w Twoim imieniu.
Tworzenie poświadczeń klucza API
Wykonaj poniższe czynności, aby utworzyć poświadczenia klucza API.
- Sprawdź, czy jesteś użytkownikiem zalogowanym na konto instytucji i masz uprawnienia do tworzenia kluczy API oraz tworzenia, aktualizowania i usuwania zasobów.
- Na stronie zasobów kliknij kartę Moje zasoby i kliknij opcję Nowy element.
- W oknie Nowy element kliknij opcję Poświadczenia programisty.
- Wybierz opcję Poświadczenia wykorzystujące klucz API i kliknij przycisk Dalej.
- W sekcji Gdzie będą używane te poświadczenia wybierz jedną z następujących opcji:
- Aplikacja publiczna — wybierz tę opcję, aby przyznać dostęp do konkretnych elementów i uprawnień usług.
- Aplikacja prywatna z wybranymi uprawnieniami i dostępem — wybierz tę opcję, aby przyznać dostęp do dowolnego zestawu elementów i uprawnień. Możesz je osadzić w prywatnej aplikacji lub komponencie po stronie serwera używanym przez aplikację publiczną.
- Aplikacja prywatna działająca w Twoim imieniu — wybierz tę opcję, aby przyznać wszystkie Twoje obecne uprawnienia oraz dostęp do zasobów, członków i ustawień instytucji.
- Kliknij przycisk Dalej.
- Opcjonalnie, jeśli została wybrana opcja Aplikacja publiczna, wybierz jedną z następujących opcji:
- Brak dostępu do elementów — to poświadczenie wymaga braku dostępu do elementów. Kliknij przycisk Dalej.
- Przyznaj dostęp do określonych elementów — należy najpierw wybrać elementy należące do bieżącego użytkownika, a następnie kliknąć przycisk Dalej.
- Opcjonalnie, jeśli wybrano opcję Aplikacja prywatna z wybranymi uprawnieniami i dostępem, wybierz jedną z następujących opcji:
- Brak dostępu do elementów — to poświadczenie wymaga braku dostępu do elementów. Kliknij przycisk Dalej.
- Przyznaj dostęp do elementów za pomocą uprawnień — wybierz uprawnienia, które są wymagane, aby umożliwić dostęp do elementów dla tego poświadczenia. Kliknij przycisk Dalej.
- Przyznaj dostęp do określonych elementów — należy najpierw wybrać elementy należące do bieżącego użytkownika, a następnie kliknąć przycisk Dalej.
- Opcjonalnie, jeśli wybrano opcję Aplikacja publiczna lub Aplikacja prywatna z wybranymi uprawnieniami i dostępem, wybierz działania, na których wykonywanie zezwolą poświadczenia aplikacji, przez przypisanie odpowiednich uprawnień. Kliknij przycisk Dalej.
Lista dostępnych uprawnień będzie się różnić w zależności od tego, czy posiadasz subskrypcję ArcGIS Location Platform i jakie masz uprawnienia w instytucji. Nie możesz nadawać uprawnień, których nie ma Twoje konto.
Informacje na temat typów uprawnień można znaleźć w podręczniku bezpieczeństwa i uwierzytelniania w pomocy firmy Esri dla deweloperów.
- Opcjonalnie, jeśli wybrano opcję Aplikacja prywatna działająca w Twoim imieniu, użyj kalendarza, aby określić datę utraty ważności poświadczeń.
Poświadczenia mogą utracić ważność następnego dnia (minimum) lub za 365 dni (maksimum). Tracą one ważność o godzinie 23:59 w dniu wybranym jako data utraty ważności. Czas jest zapisywany na podstawie czasu przeglądarki w momencie dodawania aplikacji i generowania poświadczeń.
- W sekcji Adresy URL odniesień podaj adres URL lub adres IP, z którego można się łączyć z aplikacją. W razie potrzeby kliknij przycisk Dodaj, aby dodać więcej adresów URL lub adresów IP odniesień.
Adresy URL podane podczas autoryzacji muszą być zgodne z jednym z zarejestrowanych adresów URL, w przeciwnym razie autoryzacja jest odrzucana.
Poniżej wymieniono przykłady obsługiwanych formatów adresów URL odniesienia:
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- Kliknij przycisk Dalej.
- Podaj tytuł.
- Na stronie Moje zasoby wybierz folder, w którym chcesz zapisać element.
Alternatywnie możesz wybrać z menu opcję Utwórz nowy folder i wpisać nazwę folderu, aby zapisać element w nowym folderze.
Nazwy folderów nie mogą zawierać 4-bajtowych znaków Unicode.
- Jeśli w instytucji są skonfigurowane kategorie zasobów, kliknij opcję Przypisz kategorie i wybierz maksymalnie 20 kategorii pomocnych w wyszukaniu tego elementu.
Aby zawęzić listę kategorii, możesz też zacząć wpisywać nazwę kategorii.
- Opcjonalnie wpisz znaczniki opisujące element.
Oddziel wyrażenia przecinkami (na przykład wyrażenie Obszar federalny jest traktowane jako pojedynczy znacznik, a wyrażenie obszar, federalny jest interpretowane jako dwa znaczniki).
Podczas wpisywania możesz wybrać dowolne z proponowanych znaczników. Propozycje są generowane na podstawie wcześniej dodanych znaczników.
- Opcjonalnie dodaj podsumowanie zawierające opis aplikacji.
- Kliknij przycisk Dalej.
Zostanie wyświetlone podsumowanie poświadczeń.
- Przejrzyj podsumowanie poświadczeń. Aby zmienić ustawienia, kliknij przycisk Wstecz w celu wprowadzenia zmian przed utworzeniem elementu.
- Jeśli wybrano opcję Aplikacja prywatna działająca w Twoim imieniu, kliknij pole wyboru obok opcji Przyjmuję do wiadomości i akceptuję wymogi bezpieczeństwa powiązane z wybranymi uprawnieniami.
- Kliknij przycisk Utwórz.
Aplikacja zostanie dodana do zasobów i pojawi się jej strona elementu. Oznaczenie 
wskazujące, że klucz API jest osadzony w aplikacji, pojawia się na stronie elementu, a także wtedy, gdy element jest wyświetlany na stronie zasobów lub na panelach podglądu elementu. Na karcie Informacje ogólne na stronie elementu plakietka wskazuje, czy w poświadczeniach uwzględniane są uprawnienia osobiste, czy tylko uprawnienia standardowe.