Konfigurowanie funkcji Airtable na potrzeby automatycznej aprowizacji użytkowników przy użyciu identyfikatora Entra firmy Microsoft

2025-04-10

W tym artykule opisano kroki, które należy wykonać zarówno w funkcji Airtable, jak i identyfikatorze Entra firmy Microsoft, aby skonfigurować automatyczną aprowizację użytkowników. Po skonfigurowaniu Microsoft Entra ID automatycznie dodaje i usuwa użytkowników oraz grupy w usłudze Airtable przy użyciu usługi aprowizacji firmy Microsoft. Aby uzyskać ważne szczegółowe informacje na temat działania tej usługi, sposobu jej działania i często zadawanych pytań, zobacz Automatyzowanie aprowizacji użytkowników i anulowania aprowizacji aplikacji SaaS przy użyciu identyfikatora Entra firmy Microsoft.

Obsługiwane możliwości

Tworzenie użytkowników w rozwiązaniu Airtable.
Usuń użytkowników z funkcji Airtable, gdy nie będą już wymagać dostępu.
Zachowaj synchronizację atrybutów użytkownika między identyfikatorem Entra firmy Microsoft i funkcją Airtable.
Zarządzaj grupami i członkostwami w Airtable.
logowanie jednokrotne do aplikacji Airtable (zalecane).

Wymagania wstępne

W scenariuszu opisanym w tym artykule przyjęto założenie, że masz już następujące wymagania wstępne:

dzierżawca Microsoft Entra.
Jedną z następujących ról: administrator aplikacji , administrator aplikacji w chmurze lub właściciel aplikacji .
Najemca Airtable.
Konto użytkownika w aplikacji Airtable z uprawnieniami administratora.

Krok 1: Zaplanuj wdrożenie usług

Dowiedz się więcej, jak działa usługa aprowizacji.
Ustal, kto znajduje się w zakresie udostępniania.
Określ, jakie dane mapować pomiędzy Microsoft Entra ID a Airtable.

Krok 2: Utwórz osobisty token dostępu Airtable, aby autoryzować udzielanie dostępu za pomocą Microsoft Entra ID.

Zaloguj się do usługi Airtable Developer Hub jako użytkownik administracyjny, a następnie przejdź do https://airtable.com/create/tokens.
Wybierz pozycję "Osobiste tokeny dostępu" na pasku nawigacyjnym po lewej stronie.
Utwórz nowy token z pamiętną nazwą, taką jak "AzureAdScimProvisioning".
Dodaj zakres "enterprise.scim.usersAndGroups:manage".
Wybierz "Utwórz token" i skopiuj wynikowy token do użycia w kroku 5 poniżej.

Krok 3. Dodawanie aplikacji Airtable z galerii aplikacji Microsoft Entra

Dodaj aplikację Airtable z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie konfiguracją procesów na platformie Airtable. Jeśli wcześniej skonfigurowano aplikację Airtable na potrzeby logowania jednokrotnego, możesz użyć tej samej aplikacji. Zaleca się jednak utworzenie oddzielnej aplikacji podczas początkowego testowania integracji. Więcej informacji o dodawaniu aplikacji z galerii znajdziesz tutaj.

Krok 4: Określenie, kto jest objęty zakresem aprowizacji

Usługa aprowizacji Microsoft Entra umożliwia definiowanie, kto ma być aprowizowany na podstawie przypisania do aplikacji lub na podstawie atrybutów użytkownika lub grupy. Jeśli zdecydujesz się ustalić, kto ma mieć dostęp do Twojej aplikacji na podstawie przypisania, możesz skorzystać z kroków , aby przypisać użytkowników i grupy do aplikacji. Jeśli zdecydujesz się określić zakres przyznawania zasobów wyłącznie na podstawie atrybutów użytkownika lub grupy, możesz użyć filtru zakresu.

Zacznij od małego. Przeprowadź test z użyciem mniejszego zestawu użytkowników i grup, zanim wdrożysz to rozwiązanie dla wszystkich. Jeśli zakres aprowizacji jest ustawiony na przypisanych użytkowników i grupy, możesz to kontrolować, przypisując jednego lub dwóch użytkowników lub grup do aplikacji. W przypadku ustawienia zakresu na wszystkich użytkowników i wszystkie grupy, możesz określić filtrowanie zakresu na podstawie atrybutów.
Jeśli potrzebujesz dodatkowych ról, możesz zaktualizować manifest aplikacji, aby dodać nowe role.

Krok 5: Konfigurowanie automatycznego udostępniania użytkowników do usługi Airtable

Ta sekcja zawiera instrukcje konfigurowania usługi aprowizacji firmy Microsoft w celu tworzenia, aktualizowania i wyłączania użytkowników i/lub grup w usłudze TestApp na podstawie przypisań użytkowników i/lub grup w identyfikatorze Entra firmy Microsoft.

Aby skonfigurować automatyczne udostępnianie użytkowników dla Airtable w usłudze Microsoft Entra ID:

Zaloguj się do centrum administracyjnego Microsoft Entra z uprawnieniami co najmniej Administratora aplikacji w chmurze.
Przejdź do aplikacji Entra ID>Dla przedsiębiorstw
Na liście aplikacji wybierz pozycję Airtable.
Wybierz kartę Provisionowanie.
Ustaw Tryb zaopatrywania na Automatyczny.
W sekcji Poświadczenia administratora,
1. Wprowadź https://airtable.com/scim/v2 jako adres URL numeru dzierżawy usługi Airtable .
2. Wprowadź osobisty token dostępu utworzony w krok 2 powyżej jako token tajny.
Wybierz Testuj połączenie, aby upewnić się, że Microsoft Entra ID może nawiązać połączenie z Airtable. Jeśli połączenie nie powiedzie się, upewnij się, że twoje konto Airtable ma uprawnienia administratora i że twój osobisty token dostępu posiada odpowiedni zakres uprawnień, i spróbuj to zrobić ponownie.
W polu Adres e-mail do powiadomień wpisz adres e-mail osoby lub grupy, która ma otrzymywać powiadomienia o błędach autoryzacji, a następnie zaznacz pole wyboru Wyślij powiadomienie e-mail w przypadku wystąpienia błędu.
Wybierz Zapisz.
W sekcji Mapowania wybierz pozycję Synchronizuj użytkowników Microsoft Entra zAirtable.

Przejrzyj atrybuty użytkownika zsynchronizowane z identyfikatora Entra firmy Microsoft do funkcji Airtable w sekcji Mapowanie atrybutów. Atrybuty wybrane jako właściwości pasujące do są używane do dopasowywania kont użytkowników w Airtable na potrzeby operacji aktualizacji. Jeśli zdecydujesz się zmienić pasujący atrybut docelowy, musisz upewnić się, że interfejs API funkcji Airtable obsługuje filtrowanie użytkowników na podstawie tego atrybutu. Wybierz przycisk Zapisz, aby zatwierdzić wszelkie zmiany.

Atrybut	Typ	Obsługa filtrowania	Wymagane przez funkcję Airtable
userName	Sznurek	✓	✓
aktywny	Boolowski
nazwa wyświetlana	Sznurek
tytuł	Sznurek
emails[typ eq "praca"].wartość	Sznurek
preferowany język	Sznurek
nazwa.imię	Sznurek		✓
imię.nazwisko	Sznurek		✓
nazwa.sformatowana	Sznurek
adresy[type eq "praca"].formatted	Sznurek
adresy[typ równa się "praca"].adresUlicy	Sznurek
adresy[typ eq "praca"].lokalizacja	Sznurek
addresses[type eq "praca"].region	Sznurek
adresy[typ eq "praca"].kodPocztowy	Sznurek
Adresy[typ eq "praca"].kraj	Sznurek
phoneNumbers[type eq "work"].value (numeryTelefonów[typ eq "praca"].wartość)	Sznurek
phoneNumbers[type eq "telefon komórkowy"].value	Sznurek
phoneNumbers[typ eq "fax"].wartość	Sznurek
Identyfikator zewnętrzny	Sznurek
przydomek	Sznurek
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:numerPracownika	Sznurek
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:dział	Sznurek
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.value	Sznurek
adresy[type eq "home"].formatted	Sznurek
adresy[typ eq "dom"].adresUlicy	Sznurek
addresses[type eq "home"].lokalizacja	Sznurek
adresy[typ eq "dom"].region	Sznurek
addresses[type eq "home"].kodPocztowy	Sznurek
addresses[type eq "home"].kraj	Sznurek
addresses[typ równa się "inne"].formatowane	Sznurek
adresy[type eq "inny"].adresUliczny	Sznurek
addresses[type eq "other"].lokalizacja	Sznurek
adresy[typ eq "inny"].region	Sznurek
adresy[rodzaj eq "inne"].kodPocztowy	Sznurek
adresy[typ eq "inny"].kraj	Sznurek
email[type eq "home"].value	Sznurek
email[type eq "other"].value	Sznurek
ustawienia lokalne	Sznurek
nazwa.tytułHonorowy	Sznurek
name.honorificSuffix	Sznurek
nazwa.drugieImię	Sznurek
imię.nazwisko	Sznurek
phoneNumbers[typ eq "domowy"].wartość	Sznurek
numeryTelefonów[typ równa się "inne"].wartość	Sznurek
numeryTelefonów[typ eq "pager"].wartość	Sznurek
strefa czasowa	Sznurek
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:centrum-kosztów	Sznurek
urn:ietf:params:scim:schemas:extension:enterprise:2.0:Użytkownik:dział	Sznurek
urn:ietf:params:scim:schemas:extension:enterprise:2.0:użytkownik:organizacja	Sznurek
typ użytkownika	Sznurek

W sekcji Mapowania wybierz pozycję Synchronizuj grupy Microsoft Entra z Airtable.
Przejrzyj atrybuty grupy, które są synchronizowane z Microsoft Entra ID do Airtable w sekcji Mapowanie Atrybutów. Atrybuty wybrane jako Pasujące właściwości są używane do dopasowywania grup w Airtable dla operacji aktualizacji. Wybierz przycisk Zapisz, aby zatwierdzić wszelkie zmiany.

Atrybut Typ Obsługa filtrowania Wymagane przez funkcję Airtable

nazwa wyświetlana Sznurek ✓ ✓

Członkowie Źródło
Aby skonfigurować filtry określania zakresu, zapoznaj się z poniższymi instrukcjami podanymi w artykule Filtrowanie zakresu.
Aby włączyć usługę aprowizacji Microsoft Entra dla Airtable, zmień stan aprowizacji na On w sekcji Ustawienia.
Zdefiniuj użytkowników i/lub grupy, które chcesz udostępniać do Airtable, wybierając żądane wartości w sekcji Zakres w Ustawienia.
Gdy będziesz gotowy do konfiguracji, wybierz Zapisz.

Atrybut	Typ	Obsługa filtrowania	Wymagane przez funkcję Airtable
nazwa wyświetlana	Sznurek	✓	✓
Członkowie	Źródło

Ta operacja spowoduje rozpoczęcie cyklu synchronizacji początkowej wszystkich użytkowników i grup zdefiniowanych w obszarze Zakres w sekcji Ustawienia. Cykl początkowy trwa dłużej niż kolejne cykle, które występują mniej więcej co 40 minut, pod warunkiem, że usługa wdrażania Microsoft Entra jest uruchomiona.

Krok 6. Monitorowanie wdrożenia

Po skonfigurowaniu aprowizacji użyj następujących zasobów, aby monitorować wdrożenie:

Użyj dzienników przydzielania , aby określić, którzy użytkownicy zostali pomyślnie przydzieleni lub dla których proces przydzielania się nie powiódł.
Sprawdź pasek postępu , aby zobaczyć stan cyklu wdrażania i sprawdzić, jak blisko jest do zakończenia.
Jeśli konfiguracja aprowizacji wydaje się być w złej kondycji, aplikacja przechodzi do kwarantanny. Dowiedz się więcej o stanach kwarantanny w artykule dotyczącym udostępniania aplikacji i statusu kwarantanny.

Więcej zasobów

Dowiedz się, jak przeglądać dzienniki i uzyskiwać raporty dotyczące działań przydzielania zasobów