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).
Dodawanie i rejestrowanie aplikacji z użyciem poświadczeń programisty
Autor aplikacji z kontem instytucji może dodać i zarejestrować swoją aplikację na platformie 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żesz też osadzić klucz interfejsu API w aplikacji podczas jej rejestrowania.
Typ poświadczeń programisty, które można dołączyć do aplikacji, zależy od uprawnień użytkownika w instytucji. Członek pełniący rolę administratora domyślnego lub członek roli niestandardowej z uprawnieniami do generowania kluczy API może użyć w aplikacji poświadczeń OAuth 2.0 lub poświadczeń wykorzystujących klucz API. W przeciwnym razie członek może używać w aplikacji tylko poświadczeń programisty OAuth 2.0.
Notatka:
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.
Dodawanie i rejestrowanie aplikacji z osadzonymi poświadczeniami OAuth 2.0
W przypadku korzystania z poświadczeń OAuth 2.0 w tworzonych aplikacjach token dostępu jest generowany dynamicznie podczas uzyskiwania dostępu do aplikacji. Token dostępu jest ważny przez maksymalnie 14 dni.
Wykonaj poniższe etapy, jeśli Twoja rola nie obejmuje uprawnienia do tworzenia kluczy API.
- 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.
- Wybierz opcję Poświadczenia OAuth 2.0 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 sekcji Adresy URL odniesień podaj adres URL lub adres IP, z którego można się łączyć. Kliknij opcję Dodaj, aby w razie potrzeby dodać więcej adresów URL lub adresów IP odniesień.
- W obszarze Środowisko aplikacji wybierz środowisko danej aplikacji — Wiele, Natywne, Przeglądarka lub Serwer.
- W polu Adres URL wpisz adresu URL aplikacji w formacie https://<myServer>/myWebMapApp.
- Kliknij przycisk Dalej.
Jeśli jesteś członkiem pełniącym rolę z uprawnieniem do przypisywania uprawnień aplikacjom OAuth 2.0, kliknięcie opcji Dalej spowoduje przejście do okna, w którym możesz zdefiniować, co aplikacja może robić. Jeśli nie masz tego uprawnienia, przejdź do etapu 12.
- Wybierz, jakie działania będzie mogła wykonywać aplikacja dzięki poświadczeniom, przypisując uprawnienia, a następnie kliknij opcję 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.
- Kliknij opcję Przeglądaj elementy i wybierz elementy, do których można uzyskać dostęp za pomocą osadzonych poświadczeń, a następnie kliknij opcję Dodaj elementy.
Możesz też kliknąć opcję Pomiń.
- 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.
- Przejrzyj podsumowanie poświadczeń. Aby zmienić ustawienia, kliknij przycisk Wstecz w celu wprowadzenia zmian przed utworzeniem elementu.
- Jeśli przyznano poświadczeniom uprawnienia osobiste, zaznacz pole wyboru obok potwierdzenia zgodności zabezpieczeń, aby potwierdzić ich przeczytanie i zaakceptowanie, a następnie kliknij przycisk Utwórz, aby utworzyć poświadczenia.
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.
Można skonfigurować szczegóły elementu dla aplikacji.
Kliknij opcję Wyświetl użycie na karcie Ustawienia, aby uzyskać dostęp do informacji o tym, kto zalogował się do aplikacji i ile kredytów wykorzystał.
Notatka:
Sekcja Wyświetl użycie nie jest dostępna po zalogowaniu się za pośrednictwem subskrypcji ArcGIS Location Platform.
Możesz także zarządzać ustawieniami poświadczeń osadzonych w aplikacji.
Dodawanie i rejestrowanie aplikacji z osadzonymi poświadczeniami wykorzystującymi klucz API
Użyj poświadczeń wykorzystujących klucz API, gdy musisz osadzić poświadczenia w aplikacji, a klucz musi być ważny przez ponad 14 dni.
Wykonaj poniższe czynności, aby dodać aplikację i utworzyć osadzony w niej klucz API, który będzie używany do uwierzytelniania.
- 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.
- 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ą. 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 zostanie odrzucona.
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.
- Wybierz, jakie działania będzie mogła wykonywać aplikacja dzięki poświadczeniom, przypisując uprawnienia, a następnie kliknij opcję 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.
- Kliknij opcję Przeglądaj elementy, wybierz elementy, do których można uzyskać dostęp za pomocą osadzonych poświadczeń, a następnie kliknij opcję Dodaj elementy.
Możesz też kliknąć opcję Pomiń.
- 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.
- Przejrzyj podsumowanie poświadczeń. Aby zmienić ustawienia, kliknij przycisk Wstecz w celu wprowadzenia zmian przed utworzeniem elementu.
- Jeśli przyznano poświadczeniom uprawnienia osobiste, zaznacz pole wyboru obok potwierdzenia zgodności zabezpieczeń, aby potwierdzić ich przeczytanie i zaakceptowanie, a następnie kliknij przycisk Dalej.
- Wybierz, czy chcesz wygenerować klucz API natychmiast, czy później, i kliknij przycisk Dalej.
Należy skopiować klucz interfejsu API, gdy tylko zostanie wygenerowany.
- Jeśli klikniesz opcję Wygeneruj klucz API i przejdź na stronę szczegółów elementu. Mogę skopiować i zapisać klucz, po kliknięciu przycisku Dalej zostanie wyświetlone okno podręczne Wygeneruj klucz API. Kliknij przycisk Kopiuj, aby skopiować klucz. Wklej klucz w bezpiecznym dokumencie. Po zakończeniu zamknij okno podręczne.
- Jeśli klikniesz opcję Przejdź na stronę szczegółów elementu. Wygeneruję klucz API później, zostanie wyświetlona strona elementu poświadczeń. Strona elementu zostanie wyświetlona po kliknięciu przycisku Dalej. Wygenerowanie klucza API jest możliwe na karcie Ustawienia na stronie elementu.
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.
Można skonfigurować szczegóły elementu dla aplikacji.
Kliknij opcję Wyświetl użycie na karcie Ustawienia, aby uzyskać dostęp do informacji o tym, kto zalogował się do aplikacji i ile kredytów wykorzystał.
Notatka:
Sekcja Wyświetl użycie nie jest dostępna po zalogowaniu się za pośrednictwem subskrypcji ArcGIS Location Platform.
Możesz także zarządzać ustawieniami poświadczeń osadzonych w aplikacji.