Organizacje
Organizacja grupuje dane uwierzytelniające pod jednym właścicielem, dzięki czemu wiele osób może z nich korzystać: klucze API dla JSON API oraz użytkownicy proxy dla proxy port. Wszystko, co zużywają dane uwierzytelniające organizacji, obciąża plan właściciela organizacji, a nie osoby, która wysłała request.
Gdzie to znaleźć
Zaloguj się do dashboard i otwórz Organizations na pasku bocznym. Każda organizacja, do której należysz, stanowi osobny wiersz:
| Kolumna | Co zawiera |
|---|---|
| Organization | Nazwa. Kliknij ją lub Open, aby przejść do strony organizacji. |
| Your role | Owner, Admin lub Member |
| Members | Liczba członków, wliczając właściciela |
| Keys | Liczba kluczy API należących do organizacji |
| Created | Data utworzenia |
| Actions | Open |
Tworzenie organizacji
Kliknij New organization, wpisz nazwę o długości od 2 do 60 znaków i potwierdź. Zostajesz właścicielem. Nazwa może zawierać litery, cyfry, spacje oraz . , & + ( ) - _ ', maksymalnie do ośmiu słów, bez adresu WWW. Ta sama zasada obowiązuje przy zmianie nazwy. Musi zawierać co najmniej jedną literę alfabetu łacińskiego (od a do z) lub cyfrę i nie może być taka sama jak nazwa istniejącej organizacji (porównywane są tylko litery alfabetu łacińskiego i cyfry, bez rozróżniania wielkości liter; pozostałe znaki są ignorowane).
Tworzenie organizacji wymaga planu obejmującego więcej niż jedną osobę. Wiersz Organizations you own w sekcji Usage & Limits pokazuje, czy Twój plan na to pozwala.
Role
Dostępne są trzy role, a każda organizacja ma dokładnie jednego właściciela.
| Rola | Uprawnienia |
|---|---|
| Member | Tworzenie i używanie kluczy API oraz użytkowników proxy organizacji, zmiana nazw jej kluczy API oraz podgląd członków i zespołów organizacji |
| Admin | Wszystko, co może Member, a ponadto dodawanie i usuwanie osób, zmiana ich ról, zarządzanie wszystkimi danymi uwierzytelniającymi organizacji oraz zmiana nazwy organizacji |
| Owner | Wszystko, co może Admin, a ponadto przekazanie organizacji innej osobie. Właściciel posiada plan, który rozlicza wszystkie dane uwierzytelniające organizacji. |
Właściciel nie może zostać usunięty, nie może opuścić organizacji ani zostać zdegradowany. Własność przechodzi tylko w jeden sposób: poprzez przekazanie.
Członkostwo w organizacji daje dostęp do jej danych uwierzytelniających. Członek bez uprawnień administratora nadal może utworzyć klucz lub użytkownika proxy opłacanego przez firmę, co jest celem tego rozwiązania: programista tworzący scrapery nie powinien potrzebować prywatnych danych uwierzytelniających, które po cichu obciążałyby jego konto zamiast firmy.
Strona organizacji
Kliknięcie Open w dowolnym wierszu przenosi do strony danej organizacji. U góry znajduje się sześć kart: Members (z podziałem na role: owner, admin i member poniżej), Your role, Owner, API keys, Proxy users oraz Teams. Poniżej znajdują się dwie zakładki:
- Members: lista osób w organizacji wraz z opcjami wynikającymi z Twojej roli.
- Teams: zespoły, do których należysz w ramach tej organizacji (tylko do odczytu).
Właściciele i administratorzy mają również przycisk Rename w nagłówku strony.
Dodawanie osób
Właściciele i administratorzy widzą kartę Dodaj członka nad tabelą Członkowie. Wpisz adres e-mail, wybierz opcję Członek lub Administrator i zatwierdź.
Kolejne kroki zależą od podanego adresu, a panel wskaże właściwy scenariusz:
- Adres ma już konto w FourA: użytkownik dołącza natychmiast i otrzymuje wiadomość e-mail z nazwą organizacji, informacją o osobie zapraszającej oraz uprawnieniami przypisanej roli.
- Adres nie ma konta: FourA wysyła zaproszenie e-mail, a użytkownik dołącza w momencie logowania przy użyciu tego adresu. Nie trzeba niczego klikać, a zaproszenie działa zarówno w przypadku nowej rejestracji, jak i istniejącego, nigdy nieużywanego konta.
Zaproszenia wygasają po 14 dniach. Ponowne dodanie tego samego adresu nie powoduje zdublowania zaproszenia. FourA wysyła jedno zaproszenie na dany adres i organizację na 24 godziny (wycofane zaproszenie również się wlicza): kolejna próba w tym oknie czasowym jest odrzucana komunikatem Wysłaliśmy już dzisiaj zaproszenie na ten adres. Spróbuj ponownie jutro., a wysłane wcześniej zaproszenie pozostaje ważne. Każda osoba może wysłać do 20 zaproszeń w ciągu 24 godzin we wszystkich swoich organizacjach.
Właściciel otrzymuje powiadomienie e-mail za każdym razem, gdy ktoś dołącza, ponieważ nowa osoba korzysta ze środków właściciela. Nikt nie otrzymuje potwierdzenia e-mail za własne działania.
Oczekujące zaproszenia
Dopóki aktywne jest co najmniej jedno zaproszenie, nad listą Członkowie wyświetla się tabela Zaproszenia, widoczna dla właścicieli i administratorów. Zawiera ona adres, przypisaną rolę, osobę zapraszającą oraz datę wysłania. Wygasłe zaproszenia pozostają na liście z odpowiednim oznaczeniem, dzięki czemu widać powód braku dołączenia. Użyj akcji w danym wierszu, aby wycofać zaproszenie.
Zmiana roli
Właściciele i administratorzy mogą zmienić rolę użytkownika między opcjami Członek i Administrator za pomocą menu rozwijanego w kolumnie Rola. Obowiązują trzy zasady:
- Nie możesz zmienić własnej roli. Poproś innego administratora lub opuść organizację.
- Rola właściciela nie podlega edycji w tym miejscu. Użyj zamiast tego opcji Ustaw jako właściciela.
- Każda zmiana wymaga potwierdzenia i wyświetla informację o przyszłych uprawnieniach użytkownika.
Usuwanie użytkowników i opuszczanie organizacji
Właściciele i administratorzy widzą opcję Usuń w każdym wierszu poza własnym oraz wierszem właściciela. Twój wiersz zawiera zamiast tego opcję Opuść, chyba że jesteś właścicielem: wiersz właściciela ma oznaczenie Odpowiada za rozliczenia.
Usunięcie użytkownika usuwa go również z zespołów organizacji, przez co natychmiast traci on dostęp do jej danych uwierzytelniających. Działanie to nie wpływa na same dane uwierzytelniające: klucz organizacji lub użytkownik proxy należą do organizacji, a nie do osoby, która je utworzyła.
Właściciel nie może zostać usunięty ani opuścić organizacji. Wymagane jest wcześniejsze przekazanie własności organizacji.
Przekazywanie własności organizacji
Tę operację może wykonać wyłącznie właściciel. W zakładce Członkowie kliknij Ustaw jako właściciela przy osobie przejmującej rolę i potwierdź.
Organizacja przechodzi na plan tej osoby: od tego momentu każde wywołanie jej kluczy i każdy tunel otwarty przez użytkowników proxy obciąża jej środki, transfer, limity oraz fakturę. Poprzedni właściciel staje się administratorem i zachowuje pełne uprawnienia administratorskie.
Które klucze są widoczne
Kazdy klucz nalezacy do organizacji jest widoczny dla kazdego czlonka organizacji. Roznice dotycza uprawnien do dzialan na nim:
| Akcja | Członek | Administrator | Właściciel |
|---|---|---|---|
| Uzycie klucza, odsloniecie go, tworzenie nowych kluczy organizacji | Tak | Tak | Tak |
| Zmiana nazwy, edycja opisu | Tak | Tak | Tak |
| Ponowne wygenerowanie, wylaczenie, usuniecie | Nie | Tak | Tak |
| Przeniesienie klucza poza organizacje | Nie | Nie | Tak |
Zmiana nazwy klucza jest nieszkodliwa. Ponowne wygenerowanie lub wylaczenie natychmiast blokuje prace kazdego wspolpracownika, ktory z niego korzysta, dlatego uprawnienia te maja administratorzy. Przeniesienie klucza na zewnatrz usuwa zasob z firmy i przypisuje jego uzycie do planu osoby przejmujacej, dlatego ta operacja jest dostepna wylacznie dla wlasciciela.
Zobacz Managing API Keys, aby zapoznac sie z pelnym przewodnikiem.
Ktorych uzytkownikow proxy widzisz
Uzytkownik proxy podlega tym samym trzem poziomom uprawnien, z tych samych powodow.
| Akcja | Członek | Administrator | Właściciel |
|---|---|---|---|
| Uzycie, odczyt hasla, tworzenie nowych uzytkownikow | Tak | Tak | Tak |
| Nowe haslo, wylaczenie, usuniecie, zmiana zapisanego targetowania | Nie | Tak | Tak |
| Przeniesienie poza organizacje | Nie | Nie | Tak |
Zapisane targetowanie podlega administratorom, a nie czlonkom, poniewaz zmiana konfiguracji po cichu przekierowuje kazde polaczenie wykonywane w calej organizacji przy uzyciu tych poswiadczen. Zmiana hasla wymaga tych samych uprawnien, poniewaz psuje dzialanie kazdego pliku konfiguracyjnego, w ktorym te poswiadczenia juz sie znajduja.
Firmowy downloader powinien dzialac na uzytkowniku proxy nalezacym do organizacji. Prywatny przestanie dzialac w dniu odejscia danej osoby, a kosztami obciazy bezposrednio ja. Zobacz Proxy Users, aby zapoznac sie z przewodnikiem.
Filtr wlasciciela
Gdy dolaczysz do organizacji, nad zakladkami Overview, Metrics, Activity, API Keys i Proxy pojawi sie rozwijane menu Owner. Zawiera ono trzy rodzaje opcji: Everything, Personal oraz po jednej pozycji dla kazdej organizacji. Wybor zostaje zachowany miedzy wizytami i dotyczy kazdej z tych pieciu stron.
Strony Usage & Limits oraz Billing celowo nie obsluguja tego filtra. Odpowiadaja one na pytanie "za co placic ja", co rozni sie od pytania "co moge zobaczyc": czlonek organizacji nigdy nie widzi limitow wlasciciela.
Przypisanie rozliczen
Kazde zadanie wykonane przy uzyciu klucza nalezacego do organizacji i kazdy tunel otwarty przez uzytkownika proxy nalezacego do organizacji obciaza wlasciciela organizacji, niezaleznie od tego, kto je uruchomil. To glowny powod przenoszenia poswiadczen do organizacji: zmienia to podmiot, na poczet ktorego rozliczane sa kredyty, transfer, limity planu oraz faktury.
Strona Usage & Limits wlasciciela zlicza poswiadczenia organizacji obok jego poswiadczen prywatnych, w zakladkach API keys oraz Proxy users, rozdzielajac oba zrodla, aby zrodlo kosztow bylo jasne.
Zespoly
Kazda organizacja otrzymuje domyslny zespol o nazwie Everyone. Nowe klucze trafiaja do niego automatycznie, a kazdy nowy czlonek organizacji jest do niego dodawany, dzieki czemu samo czlonkowstwo zapewnia dostep do kluczy.
Karta Zespoły wyświetla listę zespołów, do których należysz, wraz z Twoją rolą w każdym z nich, liczbą członków oraz kluczami, z których możesz korzystać (Klucze, których możesz używać). Tworzenie i edytowanie zespołów nie jest jeszcze dostępne w panelu.
Powiązane
- Zarządzanie kluczami API: Tworzenie, przenoszenie i zarządzanie kluczami w organizacji
- Użytkownicy proxy: Tworzenie i przenoszenie użytkowników proxy w organizacji
- Użycie i limity: Członkowie zespołu, organizacje i zakres Twojego planu
- Płatności i subskrypcje: Jak plan właściciela pokrywa użycie kluczy organizacji
- Przegląd panelu: Wszystkie sekcje panelu