Dodawanie kont użytkowników i zarządzanie nimi

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

Zanim użytkownicy będą mogli zacząć korzystać z portalu usług dla deweloperów, muszą zostać dodani do systemu. Domyślnie każdy użytkownik może zarejestrować się w portalu dla programistów, klikając link Zarejestruj w menu portalu. Konto użytkownika zostanie wtedy automatycznie uwierzytelnione i przypisane do roli uwierzytelnionego użytkownika.

Możesz dostosować portal dla deweloperów w taki sposób, aby konta użytkowników mogli dodawać tylko użytkownicy z uprawnieniami administratora. W takim przypadku administrator musi dodać konta użytkowników ręcznie. Administrator może też wymagać ręcznego dodania kont użytkowników dla programistów wewnętrznych lub dodania programistów w imieniu klienta.

Po dodaniu konta użytkownika administrator może przypisać mu rolę, co spowoduje powiązanie uprawnień tej roli z kontem. Oprócz tego administrator może zarządzać istniejącym kontem użytkownika, w tym edytować profil użytkownika na koncie, usunąć konto, zablokować lub odblokować konto oraz przypisać do niego nową rolę. Administrator może też określić, co się stanie z kontem użytkownika i powiązaną z nim zawartością (na przykład wpisami na blogu i postami na forum), gdy konto zostanie zlikwidowane.

Portal dla programistów może automatycznie wysyłać e-maile do użytkowników po wystąpieniu zdarzeń. Portal może na przykład wysłać e-maila, gdy użytkownik zostanie dodany, gdy konto zostanie zablokowane lub zlikwidowane. W ramach zarządzania użytkownikami możesz kontrolować treść i format tych e-maili. Więcej informacji znajdziesz w artykule o konfigurowaniu poczty e-mail.

Określanie, kto może rejestrować konta

Domyślnie każdy użytkownik może utworzyć konto w portalu dla programistów, klikając link Zarejestruj.

Aby określić, kto może rejestrować konta:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
2. W menu administrowania Drupal wybierz Konfiguracja > Osoby > Ustawienia konta. Otworzy się strona „Ustawienia konta”.
3. Kliknij odpowiednią opcję rejestracji w sekcji Kto może rejestrować konta w sekcji Rejestracja i anulowanie. Dostępne opcje to:
   • Tylko administratorzy: tylko administratorzy mogą rejestrować konta użytkowników.
   • Użytkownicy: każdy może się zarejestrować. To jest ustawienie domyślne.
   • Użytkownicy zewnętrzni, ale wymagane jest zatwierdzenie przez administratora: każdy może zarejestrować się, ale konto musi autoryzować administrator.
4. Zaznacz lub odznacz pole Wymagaj potwierdzania adresu e-mail, gdy użytkownik utworzy konto. Gdy to pole jest odznaczone, deweloper jest logowany w portalu natychmiast po rejestracji. Jeśli ta opcja jest zaznaczona, użytkownik otrzymuje e-maila, który służy do potwierdzenia adresu e-mail, zanim będzie mógł się zalogować.
5. Kliknij Save setup (Zapisz konfigurację).

Dodawanie konta użytkownika

W zależności od konfiguracji portalu administratorzy muszą dodawać użytkowników ręcznie lub mogą to robić samodzielnie, klikając link Zarejestruj w portalu dla programistów.

Ręczne dodawanie konta użytkownika

Aby ręcznie dodać konto użytkownika:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
2. W menu administrowania Drupal wybierz Osoby > Dodaj użytkownika.
3. Wpisz dane użytkownika w polach Imię, Nazwisko, Nazwa użytkownika, Adres e-mail i Hasło, a następnie potwierdź akceptację umowy z użytkownikiem.
4. Opcjonalnie ustaw Stan i role dla użytkownika.
5. Wybierz Powiadom użytkownika o nowym koncie, aby wygenerować do niego automatycznego e-maila.
6. Kliknij Utwórz konto.

Rejestrowanie użytkownika w portalu dla programistów

Aby zarejestrować użytkownika w portalu dla programistów:

1. Użytkownik wybiera Zarejestruj się na stronie głównej portalu dla programistów.
2. Pojawi się strona rejestracji.
3. Użytkownik wpisuje wymagane informacje i wybiera Utwórz nowe konto.
   W zależności od nowych ustawień rejestracji konta, po utworzeniu nowego konta użytkownik otrzyma automatycznego e-maila powitalnego.

Automatyzacja powiadomień administratora o rejestracji nowego użytkownika

Domyślnie, gdy nowy użytkownik rejestruje się w portalu, otrzymuje e-maila. Więcej informacji znajdziesz w artykule o konfigurowaniu poczty e-mail.

Administratorzy portalu nie są jednak domyślnie powiadamiani o rejestracji nowego użytkownika. Jeśli na przykład skonfigurujesz portal w taki sposób, że nowi użytkownicy będą musieli uzyskać zgodę administratora na aktywowanie konta, sprawdź, czy administratorzy są powiadamiani o utworzeniu nowego konta. W przeciwnym razie konto użytkownika pozostanie nieaktywne.

Aby powiadomić administratorów, gdy nowy użytkownik zarejestruje konto:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
2. W menu administrowania Drupal wybierz Konfiguracja > Osoby > Powiadomienie administratora.
3. W sekcji Alerty użytkownika określ, kto ma otrzymywać e-maila. Możesz skierować go do:
   • Wyślij na niestandardowy adres e-mail
   • Wyślij wiadomość do określonej roli. Jeśli wybierzesz tę opcję, możesz utworzyć nową rolę. W przeciwnym razie, jeśli wybierzesz rolę taką jak Administrator, wszyscy administratorzy otrzymają tego e-maila. Może on nie dotyczyć niektórych administratorów.
   • Obie opcje
4. Edytuj temat i treść wiadomości.
5. Wybierz opcję wysyłania e-maili, gdy:
   • Odbieraj e-maile po utworzeniu użytkownika.
   • Odbieraj e-maile po utworzeniu i aktualizacji użytkownika.
6. Kliknij Save setup (Zapisz konfigurację).

Zarządzanie kontem użytkownika

Administratorzy mogą zarządzać kontami użytkowników, aby konfigurować informacje o użytkownikach, resetować hasła, aktywować konta, anulować lub zawieszać konta oraz wykonywać inne zadania.

Aby edytować profil użytkownika konta użytkownika:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
2. W menu administrowania Drupal wybierz Osoby.
3. Korzystając z obszaru filtrowania u góry strony, możesz filtrować wyświetlane konta użytkowników według nazwy użytkownika, adresu e-mail, stanu lub uprawnień. Domyślnie dla tych filtrów jest wybrana opcja „dowolny”, co oznacza, że na stronie wymienieni są wszyscy użytkownicy.
   

   

4. Kliknij Edytuj w wierszu Nazwa użytkownika konta użytkownika. Otworzy się edytowalny widok profilu użytkownika.
5. Zmień dane w profilu użytkownika.
6. Kliknij Zapisz.

Dodaję CAPTCHA

Możesz dodać test CAPTCHA do strony logowania i innych stron, włączając moduły CAPTCHA i reCAPTCHA w systemie Drupal. Moduł reCAPTCHA dodaje obsługę bezpłatnej usługi Google reCAPTCHA.

Drupal obsługuje inne moduły CAPTCHA, takie jak obraz CAPTCHA, których możesz też używać w portalu.

Aby włączyć reCAPTCHA:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
2. W menu Drupal wybierz Modules (Moduły).
3. Włącz oba moduły CAPTCHA i reCAPTCHA.
4. Zarejestruj klucze reCAPTCHA od Google na https://www.google.com/recaptcha/intro/index.html.
5. W menu Drupal wybierz Konfiguracja > Osoby > CAPTCHA > reCAPTCHA.
6. Wpisz Klucz publiczny (klucz witryny Google) i Klucz prywatny (Tajny klucz Google). Resztę ustawień możesz pozostawić bez zmian.
7. Wybierz Konfiguracja > Osoby > CAPTCHA, aby ustawić miejsce wyświetlania formularza reCAPTCHA. Domyślnie pojawia się w formularzach logowania i rejestracji użytkowników.
8. Na tej stronie ustaw Typ wyzwania dla każdego formularza.
9. Zapisz zmiany.

Dodawanie strony Warunki korzystania z usługi

Do portalu dla programistów możesz dodać stronę z warunkami korzystania z usługi, którą użytkownicy muszą zaakceptować podczas logowania się, aby uzyskać dostęp do portalu. Jeśli później zmienisz stronę Warunki korzystania z usługi, użytkownicy będą musieli zaakceptować zaktualizowane warunki przy następnym logowaniu.

Implementacja strony Warunki korzystania z usługi wykorzystuje moduł prawny w serwisie Drupal. Moduł ten umożliwia elastyczne tworzenie strony Warunków korzystania z usługi, śledzenie historii zmian warunków usługi oraz śledzenie użytkowników, którzy je zaakceptowali.

Po utworzeniu strona z warunkami korzystania z usługi będzie miała adres URL <siteURL>/legal.

Aby włączyć moduł Dział prawny:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
2. W menu administracyjnym Drupal wybierz Modules (Moduły). Pojawi się lista wszystkich zainstalowanych modułów Drupal.
3. Przewiń stronę w dół i zaznacz pole wyboru obok modułu Informacje prawne.
4. Kliknij Save setup (Zapisz konfigurację).

Aby utworzyć stronę z warunkami korzystania z usługi:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
2. W menu administrowania Drupal wybierz Konfiguracja > Osoby > Prawo.
   To menu pojawia się tylko wtedy, gdy włączony jest moduł Dział prawny. Pole u góry strony w sekcji Najnowsza wersja/wersja zawiera bieżące warunki korzystania z usługi. Jeśli nie zdefiniowano warunków, ten obszar jest balnk. Nową wersję można utworzyć w obszarze Warunki korzystania z usługi, w sekcji Utwórz nową wersję/tłumaczenie.
3. Wpisz warunki korzystania z usługi w obszarze Warunki korzystania z usługi.
4. Wybierz sposób wyświetlania warunków korzystania z usługi na stronie: pole przewijania, pole przewijania (CSS), tekst HTML lub link do strony.
5. Opcjonalnie dodaj kolejne pola wyboru i obszar tekstowy opisujący ostatnie zmiany.
6. Wybierz Podgląd, aby wyświetlić podgląd warunków korzystania z usługi w obszarze Warunki korzystania z usługi w sekcji Najnowsza wersja/wersja, lub kliknij Zapisz, aby je zapisać.

Aby monitorować zmiany Warunków korzystania z usługi i ich akceptację:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
2. W menu administrowania Drupal wybierz Konfiguracja > Osoby > Prawo.
3. Wybierz kartę Historia warunków, aby wyświetlić historię zmian warunków.
4. Wybierz kartę Zaakceptowane, aby wyświetlić 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, domyślnie zostaje przekierowany na stronę, na której wyświetlane są jego dane, takie jak imię i nazwisko. Możesz też użyć modułu Reguły Drupal, aby dodać regułę, która będzie automatycznie przekierowywać użytkownika na inną stronę. Możesz na przykład przekierować użytkownika na stronę z listą wszystkich aplikacji lub na stronę główną portalu.

Zanim utworzysz regułę przekierowania, sprawdź, czy wszystkie niezbędne moduły Drupal są włączone.

Włącz niezbędne moduły Drupala:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
2. W menu administracyjnym Drupal wybierz Modules (Moduły).
3. Włącz te moduły, jeśli nie są jeszcze włączone:
   • Aliasy „me” (wyświetlają się u góry listy modułów, a nie w lokalizacji alfabetycznej, jak ma to miejsce w przypadku wszystkich innych modułów)
   • LoginToboggan
   • Reguły
   • Interfejs reguł
4. Kliknij Save setup (Zapisz konfigurację).
   Inne wymagane moduły mogą być włączane automatycznie.

Utwórz regułę przekierowania logowania:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
2. W menu administrowania Drupal wybierz Konfiguracja > Przepływ pracy > Reguły.
3. Na stronie Reguły kliknij + Dodaj nową regułę.
4. Podaj nazwę reguły: Przekierowanie logowania.
5. Opcjonalnie określ tag jako login.
6. W menu Reaguj na zdarzenie wybierz Użytkownik > Użytkownik zalogował się.
   
7. Kliknij Zapisz.
   Wyświetli się strona edytowania reguły reakcji. Zdarzenie zostało już ustawione w poprzednim kroku, więc powinno ono być oznaczone jako „Użytkownik zalogował się” w sekcji Zdarzenie. W przypadku tej reguły pozostaw pole Warunki puste.
8. W sekcji Działania wybierz + Dodaj działanie.
9. W menu kliknij System > Przekierowanie do strony.
   Strona Dodaj nowe działanie zmienia swój układ, aby umożliwić określenie adresu URL przekierowania.
10. W polu Wartość wpisz user/[account:uid]/apps.
    [account:uid] to wzorzec zastępcze odpowiadający identyfikatorowi portalu użytkownika. Aby zobaczyć pełną listę wzorców zastępowania, w polu do wprowadzania wartości wybierz Wzorce zastępowania.
11. Kliknij Zapisz, aby wrócić na stronę Edytowanie reguły reakcji. Powinna ona wyglądać tak:
    
12. Kliknij Zapisz zmiany.
    Aby później edytować regułę, na stronie Konfiguracja wybierz Reguły, a następnie z listy reguł wybierz Przekierowanie logowania.

Teraz po zalogowaniu się użytkownik zostanie przekierowany na stronę z listą wszystkich jego aplikacji. Jeśli chcesz przekierować ich na stronę główną portalu, zmień wartość ustawioną powyżej w kroku 11, aby podać adres URL strony głównej portalu. Na przykład http://dev-myCompany.devportal.apigee.io/.

Ustawianie ról i uprawnień użytkowników

Rola określa zestaw uprawnień, które pozwalają użytkownikowi wykonywać określone działania. Aby przyznać uprawnienia użytkownikowi lub grupie użytkowników, przypisz im rolę z odpowiednimi uprawnieniami. Administratorzy zarządzają rolami, w tym ustawiają uprawnienia ról w portalu dla programistów.

Domyślnie Drupal tworzy 2 role:

• anonimowy użytkownik – rola każdego użytkownika, który się nie zalogował; Użytkownicy anonimowi nie mogą wykonywać większości działań.
• authd user (uwierzytelniony użytkownik) – domyślna rola przypisana do wszystkich użytkowników. Możesz przypisać użytkownikowi dodatkowe role, ale zawsze będą one przypisane do tej roli.

Oprócz tego aplikacja Apigee otrzymała rolę administratora. Przypisz użytkownikom rolę administratora, by przyznać im uprawnienia administracyjne do portalu.

Zwykle do portalu dodajesz role, dzięki którym możesz rozróżniać uprawnienia na podstawie różnych typów użytkowników. Użytkownik może mieć jedną lub kilka ról. Wszyscy użytkownicy są przypisani do roli uwierzytelnionego użytkownika, ale jeśli chcesz przypisać użytkownikowi dodatkowe role, musisz dodać funkcje logiczne do portalu lub przypisać rolę ręcznie.

Aby zobaczyć wszystkie role i uprawnienia:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
2. W menu administrowania Drupal wybierz Osoby > Uprawnienia > Role.

Aby dodać nową rolę:

1. Wybierz Osoby > Uprawnienia > Role.
2. Wpisz nową nazwę roli w polu tekstowym nad przyciskiem Dodaj rolę na stronie Osoby.
3. Kliknij Dodaj rolę.

Aby edytować rolę:

1. Wybierz Osoby > Uprawnienia > Role.
2. Kliknij edytuj rolę w wierszu odpowiedniej roli na stronie Osoby.
3. Odpowiednio zmień nazwę roli.
4. Kliknij Zapisz.

Aby usunąć rolę:

1. Wybierz Osoby > Uprawnienia > Role.
2. Kliknij edytuj rolę w wierszu odpowiedniej roli na stronie Osoby.
3. Kliknij Usuń rolę.

Aby dodać użytkownika do roli:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
2. W menu administrowania Drupal wybierz Osoby.
3. Kliknij Edytuj w wierszu Nazwa użytkownika konta użytkownika. Otworzy się edytowalny widok profilu użytkownika.
4. Wybierz wszystkie role dla użytkownika.
5. Kliknij Zapisz.

Aby zmienić uprawnienia roli:

1. Wybierz Osoby > Uprawnienia > Role.
2. Na stronie Osoby kliknij kartę Uprawnienia.
   Wyświetli się tabela z rolami i uprawnieniami. Znaczniki wyboru w tabeli wskazują, które uprawnienia są przypisane do poszczególnych ról.
   

   

3. Zaznacz lub odznacz pole wyboru, aby odpowiednio przyznać lub odebrać powiązane uprawnienia do tej roli.
   Aby na przykład uniemożliwić uwierzytelnianie użytkowników tworzenie i usuwanie aplikacji, przewiń tabelę uprawnień do sekcji Aplikacje deweloperskie w DevConnet i odznacz pola Utwórz aplikacje deweloperskie i Usuń aplikacje programistów w sekcji Uwierzytelnieni użytkownicy.
4. Kliknij Zapisz uprawnienia.

Dostosowywanie pól formularza używanych do rejestrowania użytkowników

Gdy użytkownik rejestruje konto w portalu, portal wyświetla domyślną stronę rejestracji z polami First Name (Imię), Nazwisko, Nazwa użytkownika, Adres e-mail i Hasło. Jako dostawca interfejsu API możesz zmodyfikować ten formularz, aby prosił użytkownika o dodatkowe informacje, takie jak nazwa firmy, adres pocztowy lub inne dane. Portal umożliwia dodawanie nowych pól do tego formularza. Te pola mogą obejmować:

• Wymagany czy opcjonalny
• Wyświetlane przez różne elementy HTML, takie jak pola tekstowe, przyciski opcji czy pola wyboru
• Można skonfigurować tak, aby pojawiał się w dowolnym miejscu formularza

Możesz na przykład dodać pole wymagane w przypadku nazwy firmy lub opcjonalne pole numeru telefonu. Możesz też dodać kilka pól, zarówno opcjonalnych, jak i wymaganych.

Poniższa ilustracja przedstawia pole wymagane na podanie nazwy firmy w formularzu:

Jako administrator portalu możesz wyświetlać i edytować informacje o użytkowniku, w tym dowolne pola niestandardowe, poprzez:

1. W menu administrowania Drupal w portalu wybierz Osoby.
2. Kliknij Edytuj w wierszu odpowiadającym nazwie użytkownika.

Jest to podstawowy sposób uzyskiwania dostępu do informacji o użytkownikach jako administrator.

Domyślnie podczas dodawania nowych pól do formularza ich wartości nie są przesyłane do Edge. Możesz jednak skonfigurować portal tak, aby przesyłał te wartości, gdy użytkownik przesyła formularz. Oznacza to, że możesz wyświetlić te pola w Edge lub użyć interfejsu API do zarządzania Edge, aby uzyskać do nich dostęp za pomocą skryptu.

Możesz na przykład wyświetlić nowe pola formularzy w interfejsie zarządzania Edge, klikając Publikowanie > Programiści i wybierając nazwę użytkownika. Nowe wartości pól pojawią się w obszarze Atrybuty niestandardowe strony z nazwą odpowiadającą wewnętrznej nazwie pola:

Aby dodać pole do formularza rejestracji użytkownika:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
2. W menu administrowania Drupal wybierz Konfiguracja > Osoby > Ustawienia konta.
3. Kliknij przycisk Zarządzaj polami u góry strony.
4. Przewiń stronę w dół do obszaru Dodaj nowe pole:
   
5. Skonfiguruj pole. Na przykład w powyższym polu Nazwa firmy użyj tych ustawień:
   
6. Kliknij Zapisz.
7. Ponieważ jest to pole tekstowe, musisz określić jego maksymalną długość.
8. Wpisz maksymalną długość i wybierz Zapisz ustawienia pola.
9. Pojawi się nowa strona, na której możesz podać dodatkowe informacje w tym polu, m.in.:
   • Pole wyboru wskazujące tę wartość jako wymagane.
   • Pole wyboru do wyświetlania pola.
   • Opcjonalny tekst pomocy, który wyświetla się w wyskakującym okienku w formularzu.
   • Inne ustawienia.
10. Pamiętaj, aby zaznaczyć to pole, aby oznaczyć je jako wymagane.
11. Jeśli wprowadzisz zmiany na tej stronie, zapisz ustawienia.
    Zanim w formularzu pojawi się nowe pole, może być konieczne wyczyszczenie pamięci podręcznej przeglądarki.

Aby zmienić kolejność atrybutów w formularzu:

Domyślnie po polu Nazwisko w formularzu pojawiają się nowe wymagane pola. Pola opcjonalne pojawiają się u dołu formularza, za polami hasła.

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
2. W menu administrowania Drupal wybierz Konfiguracja > Osoby > Ustawienia konta.
3. Kliknij przycisk Zarządzaj polami u góry strony.
4. Wybierz symbol plusa + w kolumnie Etykieta i przeciągnij pole w miejsce, w którym chcesz je wyświetlać w formularzu.
5. Zapisz zmiany.

Zapisywanie wartości pól formularza jako niestandardowych atrybutów programisty w Edge

W Edge możesz zapisywać wartości pól formularza w niestandardowych atrybutach programisty. Atrybuty niestandardowe dewelopera możesz wyświetlać i nimi zarządzać zgodnie z opisem w sekcji Zarządzanie deweloperami aplikacji.

Po zapisaniu niestandardowych atrybutów programisty możesz na przykład użyć zasady dostępu do encji, aby włączyć dynamiczne zachowanie na podstawie wartości atrybutów niestandardowych.

Aby zapisać wartości pól jako niestandardowe atrybuty programisty w Edge:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
2. W menu administrowania Drupal wybierz Configuration > Dev Portal > Developer Attributes (Konfiguracja > Portal dla programistów > Atrybuty programisty).
   Wyświetli się lista dostępnych pól.
3. Wybierz pole, które chcesz zachować jako atrybut w Edge, np. Company Name (Nazwa firmy).
4. Zaznacz pole Zachowaj to pole jako atrybut w Edge.
5. Podaj nazwę atrybutu Edge. Ta nazwa pojawi się w kolumnie Nazwa w tabeli Atrybuty niestandardowe tego użytkownika.
6. Określ sposób działania w przypadku pustego pola/
7. Wybierz ciąg Konwertuj wartość na prawda|fałsz, jeśli przed wysłaniem tej wartości do Edge chcesz ją rzutować na wartość logiczną i przekonwertować na ciąg znaków prawda lub fałsz.
8. Kliknij Save setup (Zapisz konfigurację).
   Teraz atrybut niestandardowy zostanie przesłany do Edge, gdy użytkownik prześle formularz. Jeśli jako administrator chcesz zmienić wartość pola niestandardowego, zrób to w portalu, a nie w Edge.

Tworzenie aplikacji domyślnej, gdy użytkownik rejestruje nowe konto

Możesz automatycznie utworzyć aplikację domyślną, gdy użytkownik zarejestruje nowe konto w portalu. Gdy użytkownik zaloguje się po raz pierwszy, aplikacja pojawi się na jego stronie Moje aplikacje. W zależności od uprawnień przypisanych do roli użytkownika możesz pozwolić mu na dodawanie kolejnych aplikacji lub może to być jedyna aplikacja dostępna dla tego użytkownika.

Masz pełną kontrolę nad właściwościami aplikacji domyślnej, w tym:

• Produkty API uwzględnione w aplikacji
• stan aplikacji: oczekująca lub zatwierdzona;
• URL wywołania zwrotnego (w razie potrzeby)
• Parametry niestandardowe zastosowane do aplikacji

Sposób tworzenia domyślnej aplikacji możesz kontrolować, tworząc regułę za pomocą modułu Reguły Drupal. Reguła umożliwia zdefiniowanie działania, które występuje w odpowiedzi na zdarzenie w portalu. W tym scenariuszu zdarzeniem jest rejestrowanie przez użytkownika konta w portalu. Polega to na utworzeniu domyślnej aplikacji dla użytkownika.

Sekcja Dostosowywanie pól formularza używanych do rejestrowania aplikacji zawiera informacje o tym, jak dodać atrybuty niestandardowe używane do konfigurowania aplikacji. Te atrybuty mogą być opcjonalne lub wymagane w zależności od tego, jak je zdefiniujesz. Jeśli masz utworzone niestandardowe atrybuty aplikacji, możesz je ustawić podczas definiowania aplikacji domyślnej.

Włącz moduły reguł Drupal:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
2. W menu administracyjnym Drupal wybierz Modules (Moduły).
3. Włącz te moduły, jeśli nie są jeszcze włączone:
   • Aliasy „me” (wyświetlają się u góry listy modułów, a nie w lokalizacji alfabetycznej, jak ma to miejsce w przypadku wszystkich innych modułów)
   • LoginToboggan
   • Reguły
   • Interfejs reguł
4. Kliknij Save setup (Zapisz konfigurację).
   Inne wymagane moduły mogą być włączane automatycznie.

Utwórz regułę dodającą aplikację domyślną:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
2. W menu administrowania Drupal wybierz Konfiguracja > Przepływ pracy > Reguły.
3. Kliknij przycisk +Dodaj nową regułę.
4. Podaj nazwę reguły.
5. Opcjonalnie w polu Tagi podaj login lub inny tag, którego chcesz użyć do sklasyfikowania reguły.
6. W polu Reaguj na zdarzenie wybierz Użytkownik > Po zapisaniu nowego konta użytkownika.
7. Kliknij Zapisz.
   Pojawi się strona edytowania reguł. Zdarzenie zostało już ustawione w poprzednim kroku, więc w sekcji Zdarzenie powinno być widoczne „Po zapisaniu nowego konta użytkownika”.
8. W przypadku tej reguły pozostaw pole Warunki puste.
9. W sekcji Działania wybierz + Dodaj działanie.
10. W menu wybierz Devconnect > Create a Developer application (Utwórz aplikację programistyczną).
    Strona Dodaj nowe działanie zmienia swój układ, aby umożliwić skonfigurowanie aplikacji.
11. W polu Nazwa interfejsu API podaj nazwę domyślnej aplikacji. Na przykład wpisz [account:field_last_name] Application.
    Wartość [account:field_last_name] to wzorzec zastępcze odpowiadający nazwiskoowi użytkownika. Aby zobaczyć pełną listę wzorców zastępowania, wybierz wzorce Zastąpienie w polu do wprowadzania wartości.
12. Ustaw identyfikator UID dewelopera na [account:uid]. Ta wartość jest wymagana do powiązania użytkownika z aplikacją.
13. Ustaw stan aplikacji na oczekująca lub zatwierdzona. Ustaw stan oczekująca, jeśli administrator nadal musi zatwierdzić aplikację, zanim użytkownik będzie mógł jej użyć do uzyskania dostępu do interfejsów API.
14. W razie potrzeby ustaw URL wywołania zwrotnego dla aplikacji. To pole pojawia się tylko wtedy, gdy aplikacje są skonfigurowane tak, aby wymagały adresu URL wywołania zwrotnego. Więcej informacji o konfigurowaniu adresów URL wywołania zwrotnego znajdziesz w sekcji Konfigurowanie obsługi adresów URL wywołania zwrotnego.
15. Jeśli zdefiniowano niestandardowe atrybuty aplikacji (opcjonalne lub wymagane), ustaw je. Więcej informacji znajdziesz w artykule o dostosowywaniu pól formularza używanych do rejestracji aplikacji.
16. Określ usługi API zawarte w aplikacji.
    W obszarze tekstowym Wartość każda usługa interfejsu API musi być wymieniona w osobnym wierszu, bez przecinków ani innych ograniczników. Lista dostępnych usług API jest widoczna nad obszarem tekstowym Wartość.
17. Kliknij Zapisz, aby wrócić na stronę edytowania reguły.
18. Kliknij Zapisz zmiany.
19. Aby później edytować regułę, w menu administrowania Drupal wybierz Konfiguracja > Przepływ pracy > Reguły, a następnie wybierz regułę z listy.

Gdy nowy użytkownik loguje się w portalu po raz pierwszy i wybierze w menu link Moje aplikacje, zobaczy aplikację o nazwie lastName Application, gdzie lastName to nazwisko użyte podczas rejestrowania konta przez użytkownika.

Administrowanie aplikacjami użytkowników

Jako administrator portalu możesz używać raportu Aplikacje programisty do zarządzania aplikacjami użytkowników bezpośrednio z tego portalu. W tym raporcie administrator może wyświetlać informacje o aplikacji użytkownika oraz ją modyfikować i usuwać. Na przykład administrator portalu może zmodyfikować aplikację, aby dodać lub usunąć produkty API, zmienić URL wywołania zwrotnego czy wprowadzić inne zmiany.

Aby zarządzać aplikacją użytkownika:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
2. W menu administracyjnych Drupal wybierz Raporty > Aplikacje dla deweloperów. Pojawi się lista aplikacji użytkowników, którą można sortować.
3. W przypadku dowolnej aplikacji na liście:
   • Kliknij link Edytuj, aby edytować właściwości aplikacji.
   • Kliknij link Usuń, aby usunąć aplikację.

Anulowanie konta użytkownika

Administrator portalu może anulować konto użytkownika. Administrator może zlikwidować pojedyncze konto lub kilka kont zbiorczo.

Aby anulować pojedyncze konto użytkownika:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
2. W menu administrowania Drupal wybierz Osoby.
3. W kolumnie Operacje w tabeli użytkowników kliknij Anuluj konto.
4. Kliknij odpowiednią opcję anulowania w sekcji „Podczas anulowania konta użytkownika”. Masz do wyboru te opcje:
   • Wyłącz konto i zachowuj jego zawartość: (ustawienie domyślne) konto użytkownika i powiązane z nim treści zostaną zachowane. Konto użytkownika ma jednak zablokowany dostęp do zasobów interfejsu API. To jest ustawienie domyślne. Administrator może wówczas odblokować konto użytkownika.
   • Wyłącz konto i cofnij publikację jego treści: konto użytkownika zostanie 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 wówczas odblokować konto użytkownika.
   • Usunąć konto, ale nadać mu dostęp do anonimowego użytkownika: konto użytkownika zostanie usunięte. Treści powiązane z kontem użytkownika są zachowywane, ale są powiązane z „anonimowym” kontem użytkownika, czyli kontem, które nie zostało uwierzytelnione. Nie można ponownie włączyć konta użytkownika. Użytkownik musi ponownie się zarejestrować, a jego konto musi zostać uwierzytelnione przed uzyskaniem dostępu do zasobów interfejsu API.
   • Usunięcie konta i zawartości: 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 ponownie się zarejestrować, a jego konto musi zostać uwierzytelnione, aby uzyskać dostęp do zasobów interfejsu API.
5. Jeśli chcesz, aby użytkownik otrzymał e-maila z prośbą o potwierdzenie anulowania, wybierz „Wymagaj e-maila z potwierdzeniem anulowania konta”.
   Jeśli wybierzesz tę opcję, konto użytkownika musi mieć odpowiednie uprawnienia, aby umożliwić anulowanie subskrypcji. Wybierz Osoby > Uprawnienia i upewnij się, że rola „uwierzytelniony użytkownik” ma ustawione uprawnienie „Anuluj własne konto użytkownika”.
6. Kliknij Zlikwiduj konto.

Aby anulować wiele kont użytkowników:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora.
2. W menu administrowania Drupal wybierz Osoby.
3. W sekcji Operacje wybierz z menu Anuluj konto użytkownika.
4. Zaznacz pole wyboru obok każdego użytkownika, którego konto chcesz zlikwidować.
5. Kliknij przycisk Wykonaj.
6. Kliknij odpowiednią opcję anulowania w sekcji „Podczas anulowania konta użytkownika”. Masz do wyboru te opcje:
   • Wyłączyć konto i zachować jego zawartość.
   • Wyłącz konto i cofnij publikację jego treści.
   • Usunąć konto, ale nadać mu dostęp do anonimowego użytkownika.
   • Usunąć konto i znajdujące się na nim dane.
7. Kliknij Dalej.
8. Kliknij Potwierdź.

Ustawianie domyślnego działania po zlikwidowaniu konta

Administratorzy portalu dla programistów mogą ustawić domyślne działanie portalu w przypadku anulowania konta użytkownika.

Aby ustawić domyślne działanie po zlikwidowaniu konta:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub z uprawnieniami do tworzenia treści.
2. W menu administrowania Drupal wybierz Konfiguracja.
3. Kliknij Ustawienia konta.
4. Kliknij odpowiednią opcję anulowania w sekcji „W przypadku anulowania konta użytkownika” w sekcji Rejestracja i anulowanie. Dostępne opcje to:
   • Wyłączyć konto i zachować jego zawartość.
   • Wyłącz konto i cofnij publikację jego treści.
   • Usunąć konto, ale nadać mu dostęp do anonimowego użytkownika.
   • Usunąć konto i znajdujące się na nim dane.
5. Kliknij Zapisz konfigurację.