Dodawanie i rejestrowanie aplikacji

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.

  1. Sprawdź, czy jesteś użytkownikiem zalogowanym w instytucji i masz uprawnienia do tworzenia zasobów.
  2. Na karcie Moje zasoby strony zasobów kliknij opcję Nowy element, a następnie kliknij opcję Aplikacja.
  3. 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.
  4. W przypadku mapy internetowej, aplikacji komputerowej lub aplikacji mobilnej wpisz adres URL aplikacji, na przykład: https://<myServer>/myWebMapApp.
  5. W przypadku aplikacji komputerowej kliknij opcję Przeglądaj i wybierz plik .zip, który zawiera aplikację.
  6. Kliknij przycisk Dalej.
  7. Wpisz tytuł.
  8. Na stronie Moje zasoby wybierz folder, w którym chcesz zapisać element.
  9. 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.

  10. Opcjonalnie wpisz znaczniki opisujące element.

    Oddziel wyrażenia przecinkami (na przykład wyrażenie Obszar federalny jest traktowane jako pojedynczy znacznik, natomiast 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.

  11. Opcjonalnie dodaj podsumowanie zawierające opis aplikacji.
  12. 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 wzbogacanie danych przestrzennych. Aby dowiedzieć się więcej o uwierzytelnianiu i standardzie OAuth 2.0, przejdź na stronę Esri Developer.

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.

  1. Sprawdź, czy jesteś użytkownikiem zalogowanym na konto instytucji, które ma uprawnienie do tworzenia zasobów.
  2. Na stronie zasobów kliknij kartę Moje zasoby i kliknij opcję Nowy element.
  3. W oknie Nowy element kliknij opcję Poświadczenia programisty.
  4. 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.
  5. Wybierz opcję Poświadczenia OAuth 2.0 i kliknij przycisk Dalej.
  6. 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

  7. 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ń.
  8. W obszarze Środowisko aplikacji wybierz środowisko danej aplikacji — Wiele, Natywne, Przeglądarka lub Serwer.
  9. W polu Adres URL wpisz adresu URL aplikacji w formacie https://<myServer>/myWebMapApp.
  10. 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.

  11. 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.

  12. 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ń. Jeśli pominiesz określenie, do których elementów mają dostęp użytkownicy poświadczeń OAuth 2.0, poświadczenia mogą być używane do uzyskiwania dostępu do wszystkich elementów, których jesteś właścicielem.

  13. Wpisz tytuł.
  14. Na stronie Moje zasoby wybierz folder, w którym chcesz zapisać element.
  15. 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.

  16. Opcjonalnie wpisz znaczniki opisujące element.

    Oddziel wyrażenia przecinkami (na przykład wyrażenie Obszar federalny jest traktowane jako pojedynczy znacznik, natomiast 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.

  17. Opcjonalnie dodaj podsumowanie zawierające opis aplikacji.
  18. Kliknij przycisk Dalej.
  19. Przejrzyj podsumowanie poświadczeń. Aby zmienić ustawienia, użyj przycisku Wstecz w celu wprowadzenia zmian przed utworzeniem elementu. Jeśli ustawienia poświadczeń są prawidłowe, kliknij opcję Utwórz.

Aplikacja zostanie dodana do zasobów i pojawi się jej strona elementu. Oznaczenie poświadczeń OAuth 2.0 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.

Można skonfigurować szczegóły elementu dla aplikacji.

Na karcie Ustawienia strony elementu aplikacji można wyświetlić informacje o rejestracji zawierające identyfikator aplikacji (ID klienta), klucz tajny aplikacji (Klucz tajny klienta) oraz środowiska aplikacji. Można zaktualizować adres URL źródła danych lub adresy URL przekierowań, zresetować klucz tajny, wyrejestrować aplikację lub skopiować albo odnowić tymczasowy token aplikacji. Można także zmienić uprawnienia aplikacji i zmienić warstwy, do których aplikacja ma dostęp.

Notatka:

Zresetowanie klucza tajnego aplikacji powoduje wygaśnięcie wszystkich istniejących tokenów użytkownika i aplikacji wygenerowanych dla tej aplikacji. Użytkownicy muszą zalogować się ponownie do aplikacji. Konieczna może być także aktualizacja aplikacji skonfigurowanych za pomocą tego klucza tajnego.

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ł.

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.

  1. Sprawdź, czy jesteś użytkownikiem zalogowanym na konto instytucji i masz uprawnienia do tworzenia zasobów i kluczy API.
  2. Na stronie zasobów kliknij kartę Moje zasoby i kliknij opcję Nowy element.
  3. W oknie Nowy element kliknij opcję Poświadczenia programisty.
  4. Wybierz opcję Poświadczenia wykorzystujące klucz API i kliknij przycisk Dalej.
  5. 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ń.

  6. 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 przekierowania podane podczas autoryzacji muszą być zgodne z jednym z zarejestrowanych adresów URL, w przeciwnym razie autoryzacja zostanie odrzucona.

  7. Kliknij przycisk Dalej.
  8. 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.

  9. 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ń. Jeśli pominiesz określenie, do których elementów mają dostęp użytkownicy klucza API, poświadczenia mogą być używane do uzyskiwania dostępu do wszystkich elementów, których jesteś właścicielem.

  10. Wpisz tytuł.
  11. Na stronie Moje zasoby wybierz folder, w którym chcesz zapisać element.
  12. 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.

  13. Opcjonalnie wpisz znaczniki opisujące element.

    Oddziel wyrażenia przecinkami (na przykład wyrażenie Obszar federalny jest traktowane jako pojedynczy znacznik, natomiast 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.

  14. Opcjonalnie dodaj podsumowanie zawierające opis aplikacji.
  15. Kliknij przycisk Dalej.
  16. Przejrzyj podsumowanie poświadczeń. Aby zmienić ustawienia, użyj przycisku Wstecz w celu wprowadzenia zmian przed utworzeniem elementu. Jeśli ustawienia poświadczeń są prawidłowe, kliknij opcję Utwórz.

Aplikacja zostanie dodana do zasobów i pojawi się jej strona elementu. Oznaczenie poświadczeń wykorzystujących klucz API 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.

Można skonfigurować szczegóły elementu dla aplikacji.

Na karcie Ustawienia strony elementu aplikacji można wyświetlić informacje o rejestracji zawierające identyfikator aplikacji (ID klienta), klucz tajny aplikacji (Klucz tajny klienta) oraz środowiska aplikacji. Można zaktualizować adresy URL przekierowań, zresetować klucz tajny, wyrejestrować aplikację lub skopiować albo odnowić tymczasowy token aplikacji. Można także zmienić uprawnienia aplikacji i zmienić warstwy, do których aplikacja ma dostęp.

Notatka:

Zresetowanie klucza tajnego klienta powoduje wygaśnięcie wszystkich istniejących tokenów użytkownika i aplikacji wygenerowanych dla tej aplikacji. Użytkownicy muszą zalogować się ponownie do aplikacji. Konieczna może być także aktualizacja aplikacji skonfigurowanych za pomocą tego klucza tajnego.

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ł.

Tematy pokrewne