Dotyczy: Microsoft Cloud App SecurityApplies to: Microsoft Cloud App Security

Tokeny interfejsu APIAPI tokens

Interfejsu API programu Microsoft Cloud App Security zapewnia programowy dostęp do usługi Cloud App Security za pośrednictwem punktów końcowych interfejsu API REST.The Microsoft Cloud App Security API provides programmatic access to Cloud App Security through REST API endpoints. Aplikacje mogą używać interfejsu API, aby wykonać Odczyt i operacje aktualizacji w usłudze Cloud App Security dane i obiekty.Applications can use the API to perform read and update operations on Cloud App Security data and objects. Na przykład interfejsu API usługi Cloud App Security obsługuje następujące typowe operacje obiektu użytkownika:For example, the Cloud App Security API supports the following common operations for a user object:

  • Przekaż pliki dziennika funkcji Cloud DiscoveryUpload log files for Cloud Discovery
  • Generowanie skryptów w blokGenerate block scripts
  • Listę działań, alerty i raporty zasadList activities, alerts, and policy reports
  • Odrzuć lub rozwiązywanie alertówDismiss or resolve alerts

Aby wyświetlić pełną dokumentację interfejsu API w portalu Cloud App Security, przejdź do pomocy > dokumentacji interfejsu API.To see the full documentation of the API, in the Cloud App Security portal go to Help > API documentation.

Aby uzyskać dostęp do interfejsu API, musisz utworzyć token interfejsu API i korzystać z niego w oprogramowaniu połączyć się z interfejsu API usługi Cloud App Security.In order to access the API, you have to create an API token and use it in your software to connect to the Cloud App Security API.

Na karcie tokeny interfejsu API umożliwia pomocne w zarządzaniu wszystkie tokeny interfejsu API Twojej dzierżawy.The API tokens tab enables you to help you manage all the API tokens of your tenant.

Generowanie tokenuGenerate a token

  1. Na ustawienia menu, wybierz opcję rozszerzeń zabezpieczeń i następnie tokeny interfejsu API.On the Settings menu, select Security extensions and then API tokens.

  2. Kliknij ikonę znaku plus Wygeneruj nowy token i podaj nazwę, zidentyfikuj token w przyszłości, a następnie kliknij przycisk dalej.Click the plus icon, Generate new token and provide a name to identify the token in the future, and click Next. Usługa cloud App Security generuje token interfejsu APICloud App Security generates API token

  3. Skopiuj wartość tokenu i zapisz go w lokalizacji dostępnej dla odzyskiwania — w przypadku utraty należy ponownie wygenerować token.Copy the token value and save it somewhere for recovery - if you lose it you need to regenerate the token. Token ma uprawnienia użytkownika, który go wystawiły.The token has the privileges of the user who issued it. Na przykład Czytelnik zabezpieczeń nie można wystawić tokenu, który można zmienić danych.For example, a security reader can't issue a token that can alter data.

  4. Tokenów można filtrować według stanów: aktywne, nieaktywne lub generowane.You can filter the tokens by status: Active, Inactive, or Generated.

    • Generowane są tokenów, które nigdy nie były używane.Generated are tokens that have never been used.
    • Aktywne są tokenów, które zostały wygenerowane i zostały użyte w ciągu ostatnich siedmiu dni.Active are tokens that were generated and were used within the past seven days.
    • Zastosowano nieaktywna, ale nie było żadnych działań w ciągu ostatnich siedmiu dni.Inactive were used but there was no activity in the last seven days.
  5. Po wygenerowaniu nowego tokenu zostanie udostępniony za pomocą nowego adresu URL, aby uzyskiwać dostęp do portalu Cloud App Security.After you generate a new token, you'll be provided with a new URL to use to access the Cloud App Security portal.

    Token interfejsu API App Security chmury

Portal ogólnego adresu URL będzie nadal działać, ale jest znacznie wolniejsze niż niestandardowy adres URL podany token.The generic portal URL continues to work but is considerably slower than the custom URL provided with your token. Jeśli nie pamiętasz adres URL w każdej chwili można je wyświetlić, przechodząc do ?If you forget the URL at any time, you can view it by going to the ? Ikona w menu i wybierając polecenie o.icon in the menu and selecting About.

Token usługi API managementAPI token management

Strona token interfejsu API zawiera spis wszystkich tokeny interfejsu API, które zostały wygenerowane.The API token page includes a table of all the API tokens that were generated.

Pełne administratorzy widzą wszystkie tokeny generowany dla tej dzierżawy.Full admins see all tokens generated for this tenant. Inni użytkownicy widzą tylko tokeny one wygenerowania samodzielnie.Other users only see the tokens that they generated themselves.

Tabela zawiera szczegółowe informacje o wygenerowania tokenu i jej ostatniego i pozwala na odwoływanie tokenu.The table provides details about when the token was generated and when it was last used and allows you to revoke the token.

Po odebraniu token zostanie usunięty z tabeli i oprogramowania, który był używany nie powiedzie się wykonywania wywołań interfejsu API, dopóki nie zostanie podany nowy token.After a token is revoked, it's removed from the table, and the software that was using it fails to make API calls until a new token is provided.

Uwaga

Łączniki SIEM i moduły zbierające dzienniki również używają tokeny interfejsu API.SIEM connectors and log collectors also use API tokens. Tokeny te powinny być zarządzane z modułów zbierających dzienniki usługi i sekcje agenta SIEM i nie pojawiają się w tej tabeli.These tokens should be managed from the log collectors and SIEM agent sections and do not appear in this table.

Zobacz teżSee Also

Rozwiązywanie problemów z problemy z integracją rozwiązania SIEMTroubleshooting SIEM integration issues

Klienci wersji Premium mogą również wybrać usługę Cloud App Security bezpośrednio z Portalu Premium.Premier customers can also choose Cloud App Security directly from the Premier Portal.

Zapoznaj się z tym wideo!Check out this video!

Microsoft Cloud App Security — interfejs REST API i tokenówMicrosoft Cloud App Security – REST API’s and Tokens