Beveiliging integreren en workflows automatiseren met de Umbrella API

Downloadopties

PDF (311.5 KB)
Met Adobe Reader op diverse apparaten bekijken
ePub (152.4 KB)
Bekijken in diverse apps op iPhone, iPad, Android, Sony Reader of Windows Phone
Mobi (Kindle) (129.3 KB)
Op Kindle-apparaat of via Kindle-app op meerdere apparaten bekijken

Bijgewerkt:3 september 2025

Document-id:224766

Inclusief taalgebruik

De documentatie van dit product is waar mogelijk geschreven met inclusief taalgebruik. Inclusief taalgebruik wordt in deze documentatie gedefinieerd als taal die geen discriminatie op basis van leeftijd, handicap, gender, etniciteit, seksuele oriëntatie, sociaaleconomische status of combinaties hiervan weerspiegelt. In deze documentatie kunnen uitzonderingen voorkomen vanwege bewoordingen die in de gebruikersinterfaces van de productsoftware zijn gecodeerd, die op het taalgebruik in de RFP-documentatie zijn gebaseerd of die worden gebruikt in een product van een externe partij waarnaar wordt verwezen. Lees meer over hoe Cisco gebruikmaakt van inclusief taalgebruik.

Over deze vertaling

Cisco heeft dit document vertaald via een combinatie van machine- en menselijke technologie om onze gebruikers wereldwijd ondersteuningscontent te bieden in hun eigen taal. Houd er rekening mee dat zelfs de beste machinevertaling niet net zo nauwkeurig is als die van een professionele vertaler. Cisco Systems, Inc. is niet aansprakelijk voor de nauwkeurigheid van deze vertalingen en raadt aan altijd het oorspronkelijke Engelstalige document (link) te raadplegen.

Inhoud

Inleiding

Overzicht van Umbrella API

API-eindpunten en beheer

API Use Cases en Endpoint Groups

Toegang tot en vervaldatum API-sleutel

Authenticatie en levenscyclus token

Documentatie en middelen

steunen

Inleiding

In dit document worden de functies, configuratieopties en beschikbare bronnen voor het Umbrella API-platform beschreven.

Overzicht van Umbrella API

Het Umbrella API-platform biedt een veilige omgeving voor het bouwen, uitbreiden en integreren met Umbrella. Gebruik de API om platformonafhankelijke workflows te maken die dreigingsinformatie samenvoegen met andere beveiligingsoplossingen om de handhaving uit te breiden, de zichtbaarheid te vergroten en incidentrespons te automatiseren.

API-eindpunten en beheer

Alle Umbrella API-eindpunten worden gehost opapi.umbrella.com.
Eindpunten worden gegroepeerd per use case, elk met een specifiek pad.
API-sleutels beheren in het Umbrella-dashboard onder Beheer > API-sleutels of programmatisch met behulp van de KeyAdmin API.

API Use Cases en Endpoint Groups

Configureer elke API-sleutel met granulaire scopes gegroepeerd onder deze primaire use cases:

API-eindpunten beheren: API-sleutels en gebruikers verstrekken en beheren, rollen bekijken en klanten beheren voor providers en beheerde providers.
Auth API-eindpunten: Integraties tussen Umbrella en andere services toestaan.
Implementaties API-eindpunten: netwerken en entiteiten aanbieden, bewaken en beheren, beveiligen door ze te configureren in bestaand overkoepelend beleid.
Policies API-eindpunten: bestemmingslijsten en bestemmingen per lijst aanbieden en beheren.
API-eindpunten onderzoeken: onderzoeksdomeinen, IP-adressen en URL's die worden waargenomen door Umbrella Resolvers.
Rapporten API-eindpunten: lees en controleer real-time beveiligingsinformatie over implementaties. De App Discovery API biedt inzicht in cloud-gebaseerde applicaties.

Toegang tot en vervaldatum API-sleutel

Stel het toegangsniveau voor elk bereik in op Lezen / Schrijven of Alleen-lezen op basis van het beoogde gebruik.
Configureer API-sleutels om te verlopen op een vooraf gedefinieerde datum zoals vereist.
15143392160916

Authenticatie en levenscyclus token

API-referenties genereren toegangstokens die 60 minuten geldig zijn.
Het verificatieproces maakt gebruik van de stroom OAuth 2.0-clientreferenties.
In omgevingen met meerdere organisaties of serviceproviders kunnen API-referenties van de bovenliggende organisatie toegangstokens genereren met dezelfde scopes voor een opgegeven onderliggende organisatie tijdens de autorisatie.

Documentatie en middelen

Toegang tot uitgebreide instructies en use case documentatie.
Elke API use case wordt gedocumenteerd onder API Reference.
Alle eindpunten en parameters worden vermeld in de OpenAPI-specificatie, gekoppeld aan de onderkant van elk use case-overzicht.
Als u Legacy Umbrella API's gebruikt, raadpleegt u de API-migratiegids.
Gebruik de Postman Collection voor de Umbrella API voor de eerste tests.
Ontdek extra bronnen, leerlabs en een Sandbox voor API-tests in de sectie Cloud Security van de ontwikkelaarspagina van Cisco.