Aangepaste services

A Custom Service biedt referenties voor verificatie met Marketo. De geloofsbrieven zijn nodig om een toegangstoken van de dienst van de Identiteit van Marketo ​ te verkrijgen ​. Elke Dienst van de Douane is scoped aan één enkele API-Enige gebruiker waarvan het zijn toestemmingen afleidt.

Rollen

De eerste stap bij het maken van een aangepaste service is het maken van een rol die u kunt toepassen op de relevante gebruiker met alleen een API. Dit gebeurt in het menu Admin > Users & Roles > Roles .

Rollen zijn containers voor individuele machtigingen die toegang tot bepaalde functies toestaan of beperken. Bij abonnementen waarvoor werkruimten en partities zijn ingeschakeld, worden machtigingen per werkruimte toegewezen. Als een gebruiker een machtiging heeft in de ene werkruimte, maar niet in de andere, kunnen hij of zij alleen toegestane acties uitvoeren in die werkruimte. Als u een rol wilt maken, klikt u op de knop Nieuwe rol.

Geef uw rol een beschrijvende naam. Gebruikers met alleen een API hebben een specifieke set machtigingen die apart staan en verschillen van normale gebruikersmachtigingen. API-machtigingen bevinden zich in hun eigen hiërarchie onder de structuur van de API voor toegang.

Rolmachtigingen

Alleen machtigingen in de groep "API voor toegang" worden toegepast op API-gebruikers, dat wil zeggen dat het toewijzen van alle beheermachtigingen geen API-machtigingen aan een gebruiker verleent.

Wanneer u een rol samenstelt, moet u zorgvuldig overwegen welke handelingen u de toepassing moet toestaan om deze te gebruiken. Alleen de minimale set machtigingen toekennen die vereist is om die handelingen uit te voeren. Als u een onnodig permissieve set machtigingen toestaat, kunnen integraties ongewenste handelingen uitvoeren in uw abonnement. U kunt het ​ toestemmingenhulpmiddel ​ gebruiken om uw minimale reeks toestemmingen te bepalen. Zie de volledige lijst van ​ toestemmingen ​.

Gebruikers

Nadat u een rol hebt gemaakt, moet u een gebruiker met de eigenschap Alleen API maken. Gebruikers met alleen een API zijn een speciaal type gebruiker in Marketo, omdat ze worden beheerd door andere gebruikers en niet kunnen worden gebruikt om zich aan te melden bij Marketo. Gebruikers met alleen API kunnen:

Geef uw gebruiker een beschrijvende naam en een e-mailadres (het moet ongeldig zijn), gebaseerd op de dienst en de toepassing waarvoor het zal worden gebruikt. Vul de vereiste velden in het dialoogvenster in, klik op het selectievakje Alleen API en wijs een van uw API-rollen toe aan de gebruiker. Hiermee worden de machtigingen van die rol toegewezen aan de gebruiker.

Klik tot slot op "Verzenden" om de gebruiker met alleen de API te maken.

Wanneer levering van een nieuwe toepassing met geloofsbrieven, denk sterk na makend een nieuwe gebruiker voor de dienst zelfs als het de zelfde toestemming heeft die wordt geplaatst zoals een andere bestaande integratie. De statistieken van het het vraaggebruik van API en de fouten worden bijgehouden op een per gebruikersbasis, zodat kan de levering van een gebruiker voor elke toepassing u helpen gebruik en kwesties aan specifieke toepassingen isoleren. Dit is handig als u problemen ondervindt met het bereiken van uw dagelijkse API-aanroeplimieten of fouten die het gevolg zijn van API-aanroepen die door integratie zijn gemaakt.

Aangepaste services

De Diensten van de douane verstrekken de daadwerkelijke geloofsbrieven, identiteitskaart van de Cliënt en Geheim van de Cliënt, die worden vereist om Authentificatie met een instantie van Marketo uit te voeren. Ga naar het menu Admin > Integrations > LaunchPoint en selecteer New Service als u een voorziening wilt maken.

Geef uw dienst een beschrijvende naam en van de lijst van de "Dienst"selecteer "Douane". Geef uw service een uitgebreide beschrijving en selecteer een geschikte gebruiker in de lijst Alleen API-gebruiker en klik op Create .

Dit voegt een nieuwe dienst aan uw lijst van de diensten van LaunchPoint, en de optie aan "Details van de Mening"toe. Klik op "Details weergeven" en u krijgt de client-id en het clientgeheim die vereist zijn voor verificatie, de gebruiker die eigenaar is en een optie om token op te halen voor testdoeleinden op korte termijn. Het teken u van deze dialoog krijgt heeft het zelfde leven zoals tokens die normaal van de ​ dienst van de Identiteit ​ worden verkregen en is geldig voor 3.600 seconden van verwezenlijking.

Werkruimten en partities

Bij abonnementen met werkruimten en partities wordt de mogelijkheid om toegang te krijgen tot een bepaald record of middel verleend op basis van de machtigingen die de rol van een gebruiker in een bepaalde werkruimte heeft. Elke werkruimte krijgt toegang tot een of meer partities in het menu Werkruimten en Partities en een lead behoort tot één partitie. Als de gebruiker met alleen de API toegang heeft tot leadrecords in een werkruimte, kan deze alle records in partities openen waartoe die werkruimte toegang heeft.

Assets behoort tot werkruimten. De mogelijkheid om een element te lezen of te schrijven wordt dus bepaald door het feit of de gebruiker een rol in de relevante werkruimte heeft die gemachtigd is om dat type elementrecord in de werkruimte te lezen of te schrijven.

Machtigingenlijst

Hieronder volgt een lijst met alle machtigingen die beschikbaar zijn voor gebruikers met alleen een API en de machtigingen die gebruikers met deze machtigingen kunnen verlenen.