Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
Zanim użytkownicy zaczną korzystać z Twojego portalu Usług dla deweloperów, muszą zostać dodani do systemu. Domyślnie każdy użytkownik może zarejestrować się na portalu deweloperskim, klikając link Zarejestruj się w menu portalu. Konto użytkownika jest automatycznie uwierzytelniane, a użytkownikowi przypisywana jest rola uwierzytelnionego użytkownika.
Możesz skonfigurować portal deweloperów tak, aby tylko użytkownicy z uprawnieniami administratora mogli dodawać konta użytkowników. W takim przypadku administrator musi ręcznie dodać konta użytkowników. Administrator może też ręcznie dodawać konta użytkowników dla wewnętrznych deweloperów lub dodawać deweloperów w imieniu klienta.
Po dodaniu konta użytkownika administrator może przypisać mu rolę, która wiąże uprawnienia tej roli z kontem. Administrator może też zarządzać istniejącym kontem użytkownika, w tym edytować jego profil, usuwać je, blokować i odblokowywać je oraz przypisywać mu nową rolę. Administrator może też określić, co stanie się z kontem użytkownika i powiązanymi z nim treściami (np. wpisami na blogu i postami na forum), gdy konto zostanie anulowane.
Portal deweloperski może automatycznie wysyłać e-maile do użytkowników, gdy występują zdarzenia. Na przykład portal może wysyłać e-maile, gdy dodasz użytkownika, zablokujesz konto lub anulujesz konto. W ramach zarządzania użytkownikami możesz kontrolować zawartość i format tych e-maili. Więcej informacji znajdziesz w artykule Konfigurowanie poczty e-mail.
Aby dowiedzieć się, jak zarządzać przepływami pracy dotyczącymi rejestracji, dostosowywać e-maile rejestracyjne, blokować adresy IP, aby uniemożliwić rejestrację, oraz tworzyć, zarządzać i blokować konta użytkowników, obejrzyj ten film.
Określanie, kto może rejestrować konta
Domyślnie każdy użytkownik może utworzyć konto na portalu dewelopera, klikając link Zarejestruj się.
Aby określić, kto może rejestrować konta:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub tworzenia treści.
- W menu administracyjnym Drupala wybierz Konfiguracja > Użytkownicy > Ustawienia konta. Otworzy się strona Ustawienia konta.
- W sekcji Rejestracja i anulowanie kliknij odpowiednią opcję rejestracji w sekcji „Kto może rejestrować konta”. Dostępne opcje:
- Tylko administratorzy: tylko administratorzy mogą rejestrować konta użytkowników.
- Użytkownicy: każdy może się zarejestrować. Jest to ustawienie domyślne.
- Użytkownicy, którzy nie muszą się rejestrować, ale wymagają zatwierdzenia przez administratora: każdy może się zarejestrować, ale administrator musi zatwierdzić konto.
- Zaznacz lub odznacz pole wyboru Wymagaj weryfikacji e-maila podczas tworzenia konta przez użytkownika. Jeśli to pole nie jest zaznaczone, deweloper jest od razu logowany w portalu po zarejestrowaniu. Jeśli to pole jest zaznaczone, użytkownik otrzymuje e-maila, którego używa do potwierdzenia swojego adresu e-mail, zanim będzie mógł się zalogować.
- Kliknij Zapisz konfigurację.
Dodawanie konta użytkownika
W zależności od konfiguracji portalu administratorzy muszą dodawać użytkowników ręcznie lub użytkownicy mogą dodawać siebie, klikając link Zarejestruj się na portalu dewelopera.
Dodawanie konta użytkownika ręcznie
Aby ręcznie dodać konto użytkownika:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub tworzenia treści.
- W menu administracyjnym Drupala kliknij Osoby > Dodaj użytkownika.
- Wpisz dane użytkownika w polach Imię, Nazwisko, Nazwa użytkownika, Adres e-mail i Hasło oraz potwierdź akceptację umowy użytkownika.
- Opcjonalnie ustaw Stan i role użytkownika.
- Aby wygenerować automatycznego e-maila wysyłanego do użytkownika, wybierz Powiadom użytkownika o nowym koncie.
- Kliknij Utwórz konto.
Rejestrowanie użytkownika w portalu dla deweloperów
Aby zarejestrować użytkownika na portalu dewelopera:
- Użytkownik wybiera Zarejestruj na stronie głównej portalu dewelopera.
- Pojawi się strona rejestracji.
- Użytkownik podaje wymagane informacje i klika Utwórz nowe konto.
W zależności od ustawień rejestracji nowego konta po jego utworzeniu użytkownik otrzyma automatycznego e-maila powitalnego.
Automatyczne wysyłanie powiadomień do administratora o rejestracji nowego użytkownika
Domyślnie nowy użytkownik, który rejestruje się w portalu, otrzymuje e-maila. Więcej informacji znajdziesz w artykule Konfigurowanie poczty e-mail.
Jednak administratorzy portalu nie są domyślnie powiadamiani, gdy nowy użytkownik zarejestruje się w portalu. Jeśli na przykład skonfigurujesz portal tak, aby nowi użytkownicy musieli uzyskać zgodę administracyjną na aktywację konta, musisz się upewnić, że administratorzy zostaną powiadomieni o utworzeniu nowego konta. W przeciwnym razie konto użytkownika pozostanie nieaktywne.
Aby powiadomić administratorów, gdy nowy użytkownik zarejestruje konto:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub tworzenia treści.
- W menu administracyjnym Drupala wybierz Konfiguracja > Osoby > Powiadomienie dla administratora.
- W sekcji Alerty dla użytkowników określ, kto ma otrzymywać e-maile. Możesz go skierować do:
- Wysyłanie na niestandardowy adres e-mail
- Wyślij do konkretnej roli. Jeśli wybierzesz tę opcję, możesz utworzyć nową rolę. Jeśli wybierzesz rolę, np. administratora, wszyscy administratorzy otrzymają e-maila, ale może on nie dotyczyć wszystkich z nich.
- Obie opcje
- Edytuj temat i treść wiadomości.
- Wybierz, kiedy ma być wysyłany e-mail:
- Otrzymywać e-maile po utworzeniu użytkownika.
- otrzymywać e-maile po utworzeniu i zaktualizowaniu użytkownika.
- Kliknij Zapisz konfigurację.
Zarządzanie kontem użytkownika
Administratorzy mogą zarządzać kontami użytkowników, aby ustawiać informacje o użytkownikach, resetować hasła, aktywować konta, anulować lub zawieszać konta oraz wykonywać inne zadania.
Aby edytować profil użytkownika na koncie użytkownika:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub tworzenia treści.
- W menu administracyjnym Drupala kliknij Osoby.
- Użyj obszaru filtra u góry strony, aby wyświetlić użytkowników na podstawie konkretnej nazwy użytkownika, adresu e-mail, stanu lub uprawnień. Domyślnie w przypadku tych filtrów wybrana jest opcja „dowolny”, co oznacza, że na stronie wyświetlają się wszyscy użytkownicy.
- W wierszu Nazwa użytkownika konta użytkownika kliknij Edytuj. Otworzy się widok profilu użytkownika, który można edytować.
- W razie potrzeby zmień dane profilu użytkownika.
- Kliknij Zapisz.
Dodawanie CAPTCHA
Możesz dodać zadanie CAPTCHA do strony logowania i innych stron, włączając moduły Drupala CAPTCHA i reCAPTCHA. Moduł reCAPTCHA zapewnia obsługę bezpłatnej usługi Google reCAPTCHA.
Drupal obsługuje inne moduły CAPTCHA, takie jak CAPTCHA z obrazem, których możesz też używać w portalu.
Film: obejrzyj krótki film o włączaniu testu CAPTCHA w portalu dla deweloperów.
Aby włączyć reCAPTCHA:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub tworzenia treści.
- W menu Drupal wybierz Moduły.
- Włącz moduły CAPTCHA i reCAPTCHA.
- Zarejestruj klucze reCAPTCHA od Google na stronie https://www.google.com/recaptcha/intro/index.html.
- W menu Drupala kliknij Konfiguracja > Użytkownicy > CAPTCHA > reCAPTCHA.
- Wpisz klucz publiczny (klucz witryny Google) i klucz prywatny (klucz tajny Google). Pozostałe ustawienia możesz pozostawić w wartościach domyślnych.
- Aby określić, gdzie ma się wyświetlać formularz reCAPTCHA, wybierz Konfiguracja > Użytkownicy > CAPTCHA. Domyślnie pojawia się on w formularzach logowania i rejestracji użytkowników.
- Na tej stronie ustaw Typ wyzwania dla każdego formularza.
- Zapisz zmiany.
Dodawanie strony Warunki korzystania z usługi
Na portalu deweloperów możesz dodać stronę z Warunkami korzystania, którą użytkownicy muszą zaakceptować podczas logowania, aby uzyskać dostęp do portalu. Jeśli później zmienisz stronę Warunków korzystania z usługi, użytkownicy będą musieli zaakceptować zaktualizowane warunki przy następnym logowaniu.
Implementacja strony Warunki korzystania z usługi korzysta z modułu prawnego w Drupalu. Ten moduł umożliwia elastyczne tworzenie strony z Warunkami korzystania z usługi, śledzenie historii zmian warunków korzystania z usługi oraz śledzenie użytkowników, którzy zaakceptowali te warunki.
Po utworzeniu strona Warunki korzystania z usługi ma adres URL<siteURL>/legal
.
Aby włączyć moduł prawny:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
- W menu administracyjnym Drupala kliknij Moduły. Pojawi się lista wszystkich zainstalowanych modułów Drupal.
- Przewiń stronę w dół i zaznacz pole wyboru obok Moduł prawny.
- Kliknij Zapisz konfigurację.
Aby utworzyć stronę Warunki korzystania z usługi:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
- W menu administracyjnym Drupala wybierz Konfiguracja > Osoby > Informacje prawne.
Ten element menu jest widoczny tylko wtedy, gdy włączony jest moduł Legal. W górnym polu na stronie, pod nagłówkiem Najnowsza wersja/wersja, znajdują się aktualne warunki. Jeśli nie zdefiniujesz warunków, to pole będzie puste. Nową wersję utworzysz w obszarze Warunki i zasady, w sekcji Utwórz nową wersję/tłumaczenie. - W obszarze Warunki korzystania z usługi wpisz warunki korzystania z usługi.
- Wybierz sposób wyświetlania warunków na stronie: pole przewijania, pole przewijania (CSS), tekst HTML lub link do strony.
- Opcjonalnie możesz dodać dodatkowe pola wyboru i obszar tekstowy opisujący najnowsze zmiany.
- Kliknij Podgląd, aby wyświetlić podgląd warunków w obszarze Warunki korzystania z usługi w sekcji Najnowsza wersja/rewizja, lub Zapisz, aby zapisać warunki.
Aby sprawdzać zmiany Warunków korzystania z usługi i ich akceptację:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
- W menu administracyjnym Drupala wybierz Konfiguracja > Osoby > Informacje prawne.
- Kliknij kartę Historia warunków, aby wyświetlić historię zmian warunków.
- Wybierz kartę Zaakceptowane, aby zobaczyć listę użytkowników, którzy zaakceptowali poszczególne wersje warunków korzystania z usługi.
Przekierowywanie użytkownika po zalogowaniu
Gdy użytkownik loguje się w portalu, jest domyślnie przekierowywany na stronę z informacjami, takimi jak imię i nazwisko. Możesz też użyć modułu Reguły Drupala, aby dodać regułę automatycznego przekierowywania użytkownika na inną stronę. Możesz na przykład przekierować użytkownika na stronę ze wszystkimi jego aplikacjami lub na stronę główną portalu.
Zanim utworzysz regułę przekierowania, musisz się upewnić, że wszystkie niezbędne moduły Drupala są włączone.
Włącz niezbędne moduły Drupal:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
- W menu administracyjnym Drupala kliknij Moduły.
- Włącz te moduły, jeśli nie są jeszcze włączone:
- Aliasy „me” (znajdują się u góry listy modułów, a nie w kolejności alfabetycznej jak wszystkie inne moduły)
- LoginToboggan
- Reguły
- Interfejs zasad
- Kliknij Zapisz konfigurację.
Możesz zauważyć, że inne wymagane moduły są włączane automatycznie.
Utwórz regułę przekierowania logowania:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
- W menu administracyjnym Drupala kliknij Konfiguracja > Proces > Reguły.
- Na stronie Reguły kliknij + Dodaj nową regułę.
- Podaj nazwę reguły: Przekierowanie po zalogowaniu.
- Opcjonalnie możesz określić tag jako login.
- W menu rozwijanym Działanie w przypadku zdarzenia wybierz Użytkownik > Użytkownik zalogował się.
- Kliknij Zapisz.
Pojawi się strona Edytowanie reguły reakcji. Zdarzenie zostało już skonfigurowane w poprzednim kroku, więc w sekcji Zdarzenie powinno być widoczne „Użytkownik zalogował się”. W przypadku tej reguły pozostaw pole Warunki puste. - W sekcji Czynności kliknij + Dodaj działanie.
- W menu kliknij System > Przekierowanie na stronę.
Strona Dodawanie nowego działania zmienia układ, aby umożliwić Ci podanie adresu URL przekierowania. - W polu Wartość wpisz user/[account:uid]/apps.
[account:uid] to wzór zastępczy odpowiadający identyfikatorowi portalu użytkownika. Aby zobaczyć pełną listę wzorów zastępowania, w polu wartości kliknij Wzory zastępowania. - Kliknij Zapisz, aby wrócić do strony Edytowanie reguły reakcji. Ta strona powinna wyglądać tak:
- Kliknij Zapisz zmiany.
Aby później edytować regułę, na stronie Konfiguracja kliknij Reguły, a na liście reguł wybierz przekierowanie Logowanie.
Gdy użytkownik zaloguje się na konto, zostanie przekierowany na stronę ze wszystkimi jego aplikacjami. Jeśli chcesz przekierowywać użytkowników na stronę główną portalu, zamiast tego zmodyfikuj wartość ustawioną powyżej w kroku 11, aby podać adres URL strony głównej portalu. Na przykład: http://dev-myCompany.devportal.apigee.io/.
Konfigurowanie ról i uprawnień użytkowników
Rola określa określony zestaw uprawnień, które umożliwiają użytkownikowi wykonywanie określonych działań. Uprawnienia przyznajesz użytkownikowi lub grupie użytkowników, przypisując użytkownikowi rolę z wymaganymi uprawnieniami. Administratorzy zarządzają rolami, w tym ustawieniami uprawnień dla ról, na portalu deweloperskim.
Domyślnie Drupal tworzy 2 role:
- Użytkownik anonimowy – rola każdego użytkownika, który nie jest zalogowany. Użytkownicy anonimowi nie mogą wykonywać większości działań.
- Uwierzytelniony użytkownik – domyślna rola przypisana wszystkim użytkownikom. Możesz przypisać użytkownikowi dodatkowe role, ale zawsze będzie on mieć tę rolę.
Dodatkowo Apigee dodało rolę administratora. Przypisz użytkowników do roli administratora, aby przyznać im prawa administracyjne w portalu.
Zazwyczaj role dodaje się do portalu, aby można było różnicować uprawnienia na podstawie różnych typów użytkowników. Użytkownik może pełnić jedną lub wiele ról. Wszyscy użytkownicy mają przypisaną rolę uwierzytelnionego użytkownika, ale jeśli chcesz przypisać użytkownikowi dodatkowe role, musisz dodać do portalu logikę lub przypisać rolę ręcznie.
Aby wyświetlić wszystkie role i uprawnienia:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub tworzenia treści.
- W menu administracyjnym Drupala wybierz Osoby > Uprawnienia > Role.
Aby dodać nową rolę:
- Kliknij Osoby > Uprawnienia > Role.
- Wpisz nową nazwę roli w polu tekstowym nad przyciskiem Dodaj rolę na stronie Osoby.
- Kliknij Dodaj rolę.
Aby edytować rolę:
- Kliknij Osoby > Uprawnienia > Role.
- Na stronie z listą osób w wierszu odpowiedniej roli kliknij edytuj rolę.
- W razie potrzeby zmień nazwę roli.
- Kliknij Zapisz.
Aby usunąć rolę:
- Kliknij Osoby > Uprawnienia > Role.
- Na stronie z listą osób w wierszu odpowiedniej roli kliknij edytuj rolę.
- Kliknij Usuń rolę.
Aby dodać użytkownika do roli:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub tworzenia treści.
- W menu administracyjnym Drupala kliknij Osoby.
- W wierszu Nazwa użytkownika konta użytkownika kliknij Edytuj. Otworzy się widok profilu użytkownika, który można edytować.
- W razie potrzeby wybierz wszystkie role dla użytkownika.
- Kliknij Zapisz.
Aby zmienić uprawnienia roli:
- Kliknij Osoby > Uprawnienia > Role.
- Na stronie Osoby kliknij kartę Uprawnienia.
Wyświetli się tabela ról i uprawnień. Znaczniki wyboru w tabeli wskazują, które uprawnienia są przypisane do poszczególnych ról.
- Zaznacz lub odznacz pole wyboru, aby przyznać lub cofnąć powiązane uprawnienia tej roli.
Aby na przykład uniemożliwić uwierzytelnionych użytkownikom tworzenie i usuwanie aplikacji, przewiń w dół do sekcji Aplikacje dla deweloperów DevConnet w tabeli uprawnień i odznacz pola Utwórz aplikację dla dewelopera i Usuń aplikację dla dewelopera w sekcji Uwierzytelnieni użytkownicy. - Kliknij Zapisz uprawnienia.
Dostosowywanie pól formularza służących do rejestracji użytkownika
Gdy użytkownik rejestruje konto w portalu, wyświetla się domyślna strona rejestracji z polami na imię, nazwisko, nazwę użytkownika, adres e-mail i hasło. Jako dostawca interfejsu API możesz zmodyfikować ten formularz, aby zachęcić użytkownika do podania dodatkowych informacji, takich jak nazwa firmy, adres pocztowy lub inne dane. Na portalu możesz dodawać do tego formularza nowe pola. Te pola mogą być:
- Wymagana czy opcjonalna
- Wyświetlane przez różne elementy HTML, takie jak pola tekstowe, pola wyboru, pola wyboru i inne
- może być ustawiony tak, aby pojawiał się w dowolnym miejscu formularza;
Aby dowiedzieć się, jak dostosować formularz rejestracji użytkownika dostępny w portalu deweloperskim, obejrzyj ten film.
Możesz na przykład dodać pole wymagane dla nazwy firmy lub pole opcjonalne dla numeru telefonu. Możesz też dodać kilka pól, zarówno opcjonalnych, jak i wymaganych.
Na poniższym obrazie widać wymagane pole Nazwa firmy dodane do formularza:
Jako administrator portalu możesz wyświetlać i edytować informacje o użytkowniku, w tym pola niestandardowe, wykonując te czynności:
- Wybranie Osoby w menu administracyjnym Drupala na portalu.
- Kliknięcie Edytuj w wierszu odpowiadającym nazwie użytkownika.
Jest to główny sposób, w jaki jako administrator uzyskujesz dostęp do informacji o użytkownikach.
Domyślnie, gdy dodasz do formularza nowe pola, ich wartości nie są przesyłane do Edge. Możesz jednak skonfigurować portal tak, aby przesyłał te wartości, gdy użytkownik prześle formularz. Oznacza to, że możesz wyświetlać te pola w Edge lub używać interfejsu Edge Management API, aby uzyskać do nich dostęp ze skryptu.
Aby wyświetlić nowe pola formularza w interfejsie zarządzania Edge, otwórz Opublikuj > Deweloperzy,a potem wybierz nazwę użytkownika. Nowe wartości pól pojawią się w obszarze Atrybuty niestandardowe na stronie o nazwie odpowiadającej nazwie wewnętrznej pola:
Aby dodać pole do formularza rejestracji użytkownika:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub tworzenia treści.
- W menu administracyjnym Drupala wybierz Konfiguracja > Użytkownicy > Ustawienia konta.
- U góry strony kliknij przycisk Zarządzaj polami.
- Przewiń stronę w dół do obszaru Dodaj nowe pole:
- Skonfiguruj pole. Na przykład w przypadku pola Nazwa firmy widocznego powyżej użyj tych ustawień:
- Kliknij Zapisz.
- Ponieważ jest to pole tekstowe, pojawi się prośba o określenie maksymalnej długości pola.
- Wpisz maksymalną długość i kliknij Zapisz ustawienia pola.
- Pojawi się nowa strona, na której możesz podać dodatkowe informacje dotyczące pola, w tym:
- Pole wyboru, które umożliwia ustawienie tego pola jako wymagane.
- Pole wyboru, które umożliwia wyświetlanie pola.
- Opcjonalny tekst pomocy wyświetlany w wyskakującym okienku w formularzu.
- Inne ustawienia.
- Zaznacz pole wyboru, aby ustawić to pole jako wymagane.
- Jeśli wprowadzisz na tej stronie jakiekolwiek zmiany, zapisz ustawienia.
Aby nowe pole pojawiło się w formularzu, konieczne może być wyczyszczenie pamięci podręcznej przeglądarki.
Aby zmienić kolejność atrybutów w formularzu:
Domyślnie nowe wymagane pola pojawiają się w formularzu po polu „Nazwisko”. Opcjonalne pola są widoczne u dołu formularza, po polach z hasłem.
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub tworzenia treści.
- W menu administracyjnym Drupala kliknij Konfiguracja > Użytkownicy > Ustawienia konta.
- Kliknij przycisk Zarządzaj polami u góry strony.
- Kliknij znak plusa + w kolumnie Etykieta i przeciągnij pole w miejsce, w którym chcesz je wyświetlić w formularzu.
- Zapisz zmiany.
Zapisywanie wartości pól formularza jako niestandardowych atrybutów dewelopera w Edge
Wartości pól formularza możesz zapisać w niestandardowych atrybutach dewelopera w Edge. Atrybuty niestandardowe dewelopera możesz wyświetlać i nimi zarządzać w sposób opisany w artykule Zarządzanie deweloperami aplikacji.
Po zapisaniu niestandardowych atrybutów dewelopera możesz użyć zasad dotyczących dostępu do jednostek, aby na przykład włączyć dynamiczne działanie na podstawie wartości atrybutów niestandardowych.
Aby dowiedzieć się, jak zapisywać wartości pól formularza jako niestandardowe atrybuty dewelopera, obejrzyj ten film.
Aby zapisać wartości pól jako atrybuty niestandardowe dewelopera w Edge:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub tworzenia treści.
- W menu administracyjnym Drupala wybierz Konfiguracja > Portal dewelopera > Atrybuty dewelopera.
Wyświetli się lista dostępnych pól. - Wybierz pole, które chcesz zachować jako atrybut w Edge, np. Nazwa firmy.
- Zaznacz pole wyboru Zapisz to pole jako atrybut w Edge.
- Podaj nazwę atrybutu Edge. Jest ona widoczna w kolumnie Nazwa w tabeli Atrybuty niestandardowe dla danego użytkownika.
- Określ zachowanie w przypadku pustego pola.
- Wybierz ciąg znaków Convert value to true|false (Przekształcanie wartości na true|false), jeśli chcesz rzutować wartość jako wartość logiczną i przed wysłaniem do Edge przekształcać ją w ciąg znaków true lub false.
- Kliknij Zapisz konfigurację.
Atrybuty niestandardowe będą teraz przesyłane do Edge, gdy użytkownik prześle formularz. Jeśli jako administrator chcesz zmienić wartość pola niestandardowego, zrób to na portalu, a nie w Edge.
Tworzenie domyślnej aplikacji, gdy użytkownik rejestruje nowe konto
Możesz automatycznie utworzyć domyślną aplikację, gdy użytkownik zarejestruje nowe konto portalu. Gdy użytkownik zaloguje się po raz pierwszy, aplikacja pojawi się na stronie Moje aplikacje. W zależności od uprawnień przypisanych do roli użytkownika możesz zezwolić mu na dodawanie dodatkowych aplikacji lub może to być jedyna aplikacja dostępna dla użytkownika.
Masz pełną kontrolę nad właściwościami domyślnej aplikacji, w tym:
- Usługi interfejsu API uwzględnione przez aplikację
- Stan aplikacji: oczekuje na zatwierdzenie lub została zatwierdzona.
- Adres URL wywołania zwrotnego (jeśli to konieczne).
- Parametry niestandardowe zastosowane w aplikacji
Aby kontrolować tworzenie aplikacji domyślnej, utwórz regułę za pomocą modułu Drupal Rules. Reguła umożliwia zdefiniowanie działania, które odbywa się w odpowiedzi na zdarzenie w portalu. W tym scenariuszu zdarzeniem jest rejestracja użytkownika na koncie w portalu. Działanie polega na utworzeniu domyślnej aplikacji dla użytkownika.
W sekcji Dostosowywanie pól formularza służących do rejestrowania aplikacji opisaliśmy, jak dodawać atrybuty niestandardowe, które służą do konfigurowania aplikacji. Te atrybuty mogą być opcjonalne lub wymagane, w zależności od ich definicji. Jeśli masz niestandardowe atrybuty aplikacji, możesz je ustawić podczas definiowania domyślnej aplikacji.
Włącz moduły reguł Drupal:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
- W menu administracyjnym Drupala kliknij Moduły.
- Włącz te moduły, jeśli nie są jeszcze włączone:
- Aliasy „me” (znajdują się u góry listy modułów, a nie w kolejności alfabetycznej jak wszystkie inne moduły)
- LoginToboggan
- Reguły
- Interfejs zasad
- Kliknij Zapisz konfigurację.
Możesz zauważyć, że inne wymagane moduły są włączane automatycznie.
Utwórz regułę, aby dodać aplikację domyślną:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
- W menu administracyjnym Drupala kliknij Konfiguracja > Proces > Reguły.
- Kliknij przycisk +Dodaj nową regułę.
- Podaj nazwę reguły.
- Opcjonalnie w polu Tagi podaj dane logowania lub dowolny inny tag, którego chcesz użyć do kategoryzowania reguły.
- W menu Reaguj na zdarzenie kliknij Użytkownik > Po zapisaniu nowego konta użytkownika.
- Kliknij Zapisz.
Pojawi się strona edycji reguły. Zdarzenie zostało już skonfigurowane w poprzednim kroku, więc w sekcji Zdarzenie powinno być widoczne „Po zapisaniu nowego konta użytkownika”. - W przypadku tej reguły pozostaw pole Warunki puste.
- W sekcji Działania kliknij + Dodaj działanie.
- W menu kliknij Devconnect > Utwórz aplikację dla deweloperów.
Strona Dodaj nowe działanie zmienia układ, aby umożliwić konfigurowanie aplikacji. - W polu Nazwa interfejsu API wpisz nazwę domyślnej aplikacji. Użyj na przykład tego wyrażenia:[account:field_last_name]
Application.
Wartość [account:field_last_name] to wzór zastępowania odpowiadający nazwisku użytkownika. Aby zobaczyć pełną listę wzorów wymiany, w polu Wartość wybierz Wymiana. - Ustaw Identyfikator dewelopera na [account:uid]. Ta wartość jest wymagana do powiązania użytkownika z aplikacją.
- Ustaw stan aplikacji na oczekuje lub zatwierdzona. Ustaw ją na oczekuje, jeśli administrator musi najpierw zatwierdzić aplikację, zanim użytkownik będzie mógł uzyskać dostęp do interfejsów API.
- W razie potrzeby skonfiguruj adres URL wywołania zwrotnego dla aplikacji. To pole jest widoczne tylko wtedy, gdy skonfigurowano aplikacje tak, aby wymagały adresu URL wywołania zwrotnego. Więcej informacji o konfigurowaniu adresów URL wywołań zwrotnych znajdziesz w artykule Konfigurowanie obsługi adresów URL wywołań zwrotnych.
- Jeśli zdefiniujesz niestandardowe atrybuty aplikacji (opcjonalne lub wymagane), skonfiguruj je. Więcej informacji znajdziesz w artykule Dostosowywanie pól formularza służących do rejestracji aplikacji.
- Określ produkty interfejsu API uwzględnione w aplikacji.
Obszar tekstowy Wartość musi zawierać po jednym produkcie interfejsu API w oddzielnym wierszu, bez przecinków ani innych rozdzielaczy. Lista dostępnych usług interfejsu API znajduje się nad obszarem tekstowym Wartość. - Kliknij Zapisz, aby wrócić do strony Edytowanie reguły.
- Kliknij Zapisz zmiany.
- Aby później edytować regułę, w menu administracyjnym Drupala kliknij Konfiguracja > Proces > Reguły, a następnie wybierz regułę na liście reguł.
Gdy nowy użytkownik loguje się na portalu po raz pierwszy i wybiera w menu link Moje aplikacje, widzi aplikację o nazwie lastName Application, gdzie lastName to ostatnie imię i nazwisko użytkownika użyte podczas rejestracji konta.
Zarządzanie aplikacjami użytkowników
Jako administrator portalu możesz zarządzać aplikacjami użytkowników bezpośrednio z poziomu raportu Aplikacje dewelopera. Na podstawie tego raportu administrator może wyświetlać informacje o aplikacji użytkownika, modyfikować ją lub usuwać. Na przykład administrator portalu może zmodyfikować aplikację, aby dodać lub usunąć produkty API, zmienić adres URL wywołania zwrotnego lub wprowadzić inne zmiany.
Aby zarządzać aplikacją użytkownika:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
- W menu administracyjnym Drupala kliknij Raporty > Aplikacje dewelopera. Pojawi się sortowalna lista aplikacji użytkownika.
- W przypadku każdej aplikacji z listy:
- Aby edytować właściwości aplikacji, kliknij link Edytuj.
- Kliknij link Usuń, aby usunąć aplikację.
Anulowanie konta użytkownika
Administrator portalu może anulować konto użytkownika. Administrator może anulować pojedyncze konto lub anulować wiele kont zbiorczo.
Aby anulować subskrypcję kont poszczególnych użytkowników:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
- W menu administracyjnym Drupala kliknij Osoby.
- W kolumnie Operacje tabeli użytkowników wybierz Anuluj konto.
- W sekcji „Podczas anulowania konta użytkownika” kliknij odpowiednią opcję anulowania. Masz do wyboru:
- Wyłącz konto i zachowaj jego zawartość: (wartość domyślna) konto użytkownika i powiązane z nim treści pozostają zachowane. Konto użytkownika ma jednak zablokowany dostęp do zasobów interfejsu API. Jest to ustawienie domyślne. Administrator może odblokować konto użytkownika.
- Zablokuj konto i usunij jego treści: konto użytkownika zostaje zachowane. Jednak treści powiązane z kontem użytkownika zostaną usunięte. Konto użytkownika ma zablokowany dostęp do zasobów interfejsu API. Administrator może odblokować konto użytkownika.
- Usuń konto, ale jego treści przypisz użytkownikowi anonimowemu: Konto użytkownika zostanie usunięte. Treści powiązane z kontem użytkownika są zachowywane, ale są powiązane z kontem „Anonimowy”, czyli z kontem, które nie zostało uwierzytelnione. Nie można ponownie włączyć konta użytkownika. Użytkownik musi się ponownie zarejestrować, a jego konto musi zostać uwierzytelnione, zanim będzie można uzyskać dostęp do zasobów interfejsu API.
- Usuń konto i jego zawartość: konto użytkownika i powiązane z nim treści zostaną usunięte. Nie można ponownie włączyć konta użytkownika. Użytkownik musi się ponownie zarejestrować, a jego konto musi zostać uwierzytelnione, zanim będzie można uzyskać dostęp do zasobów interfejsu API.
- Jeśli chcesz, aby użytkownik otrzymał e-maila z prośbą o potwierdzenie anulowania, wybierz „Wymagaj potwierdzenia przez e-maila, aby anulować konto”.
Jeśli wybierzesz tę opcję, konto użytkownika musi mieć odpowiednie uprawnienia, aby umożliwić anulowanie. Kliknij Osoby > Uprawnienia i upewnij się, że dla roli „Zalogowany użytkownik” jest ustawione uprawnienie „Anulowanie własnego konta użytkownika”. - Kliknij Anuluj konto.
Aby anulować wiele kont użytkowników:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
- W menu administracyjnym Drupala kliknij Osoby.
- W sekcji Operacje kliknij Anuluj konto użytkownika w menu.
- Zaznacz pole wyboru obok każdego użytkownika, którego konto chcesz anulować.
- Kliknij przycisk Wykonaj.
- W sekcji „Podczas anulowania konta użytkownika” kliknij odpowiednią opcję anulowania. Masz do wyboru:
- Wyłącz konto, zachowując jego zawartość.
- Wyłącz konto i usuń jego treści z publikacji.
- Usuń konto, ale zachowaj jego zawartość dla anonimowego użytkownika.
- Usuń konto i jego zawartość.
- Kliknij Dalej.
- Kliknij Potwierdź.
Ustawianie domyślnego działania w przypadku anulowania konta
Administratorzy portalu dla deweloperów mogą ustawić domyślne działanie portalu, gdy konto użytkownika zostanie anulowane.
Aby ustawić domyślne działanie w przypadku anulowania konta:
- Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub tworzenia treści.
- W menu administracyjnym Drupala kliknij Konfiguracja.
- Kliknij Ustawienia konta.
- W sekcji Rejestracja i anulowanie kliknij odpowiednią opcję anulowania w sekcji „Podczas anulowania konta użytkownika”. Dostępne opcje:
- Wyłącz konto, zachowując jego zawartość.
- Wyłącz konto i usuń jego treści z publikacji.
- Usuń konto, ale zachowaj jego zawartość dla anonimowego użytkownika.
- Usuń konto i jego zawartość.
- Kliknij Zapisz konfigurację.