applicationTemplate: instanciar
Namespace: microsoft.graph
Adicione uma instância de um aplicativo da galeria de aplicativos Microsoft Entra ao diretório.
O modelo de aplicativo com ID 8adf8e6e-67b2-4cf2-a259-e3dc5476c621
pode ser usado para adicionar um aplicativo que não seja de galeria que você pode configurar diferentes modos de SSO (logon único), como sSO saml e SSO baseado em senha.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | Application.ReadWrite.All | Directory.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | Application.ReadWrite.OwnedBy | Application.ReadWrite.All, Directory.ReadWrite.All |
Solicitação HTTP
POST /applicationTemplates/{applicationTemplate-id}/instantiate
Para instanciar aplicativos que não são de galeria, use o 8adf8e6e-67b2-4cf2-a259-e3dc5476c621
para o {applicationTemplate-id}
.
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Authorization | Portador {code} |
Corpo da solicitação
Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.
Parâmetro | Tipo | Descrição |
---|---|---|
displayName | Cadeia de caracteres | Nome personalizado do aplicativo |
Resposta
Se for bem-sucedido, esse método retornará um 201 Created
código de resposta e um novo objeto applicationServicePrincipal no corpo da resposta.
Exemplos
O exemplo a seguir mostra como chamar essa API.
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/v1.0/applicationTemplates/229946b9-a9fb-45b8-9531-efa47453ac9e/instantiate
Content-type: application/json
{
"displayName": "Azure AD SAML Toolkit"
}
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 201 Created
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.applicationServicePrincipal",
"application": {
"id": "20845737-a145-446f-aa3c-77d432903957",
"appId": "3c653ec4-4e4c-4820-8127-49e3889cad99",
"applicationTemplateId": "229946b9-a9fb-45b8-9531-efa47453ac9e",
"createdDateTime": "2022-04-25T16:48:24Z",
"deletedDateTime": null,
"displayName": "Azure AD SAML Toolkit",
"groupMembershipClaims": null,
"identifierUris": [],
"isFallbackPublicClient": false,
"signInAudience": "AzureADMyOrg",
"tags": [],
"tokenEncryptionKeyId": null,
"defaultRedirectUri": null,
"optionalClaims": null,
"addIns": [],
"api": {
"acceptMappedClaims": null,
"knownClientApplications": [],
"requestedAccessTokenVersion": null,
"oauth2PermissionScopes": [
{
"adminConsentDescription": "Allow the application to access Azure AD SAML Toolkit on behalf of the signed-in user.",
"adminConsentDisplayName": "Access Azure AD SAML Toolkit",
"id": "00e7ef81-4deb-41d7-9ee3-90d4eba1e991",
"isEnabled": true,
"type": "User",
"userConsentDescription": "Allow the application to access Azure AD SAML Toolkit on your behalf.",
"userConsentDisplayName": "Access Azure AD SAML Toolkit",
"value": "user_impersonation"
}
],
"preAuthorizedApplications": []
},
"appRoles": [
{
"allowedMemberTypes": [
"User"
],
"displayName": "msiam_access",
"id": "8b292bda-39b6-4b77-849e-887565235bb0",
"isEnabled": true,
"description": "msiam_access",
"value": null,
"origin": "Application"
}
],
"info": {
"logoUrl": null,
"marketingUrl": null,
"privacyStatementUrl": null,
"supportUrl": null,
"termsOfServiceUrl": null
},
"keyCredentials": [],
"parentalControlSettings": {
"countriesBlockedForMinors": [],
"legalAgeGroupRule": "Allow"
},
"passwordCredentials": [],
"publicClient": {
"redirectUris": []
},
"requiredResourceAccess": [],
"verifiedPublisher": {
"displayName": null,
"verifiedPublisherId": null,
"addedDateTime": null
},
"web": {
"homePageUrl": "https://samltoolkit.azurewebsites.net/SAML/Consume?metadata=samltoolkit|ISV9.2|primary|z",
"redirectUris": [
"https://samltoolkit.azurewebsites.net/SAML/Consume"
]
}
},
"servicePrincipal": {
"id": "912729dd-97ae-4ceb-ade4-07bed3046486",
"deletedDateTime": null,
"accountEnabled": true,
"appId": "3c653ec4-4e4c-4820-8127-49e3889cad99",
"applicationTemplateId": "229946b9-a9fb-45b8-9531-efa47453ac9e",
"appDisplayName": "Azure AD SAML Toolkit",
"alternativeNames": [],
"appOwnerOrganizationId": "29a4f813-9274-4e1b-858d-0afa98ae66d4",
"displayName": "Azure AD SAML Toolkit",
"appRoleAssignmentRequired": true,
"loginUrl": null,
"logoutUrl": null,
"homepage": "https://samltoolkit.azurewebsites.net/SAML/Consume?metadata=samltoolkit|ISV9.2|primary|z",
"notificationEmailAddresses": [],
"preferredSingleSignOnMode": null,
"preferredTokenSigningKeyThumbprint": null,
"replyUrls": [
"https://samltoolkit.azurewebsites.net/SAML/Consume"
],
"servicePrincipalNames": [
"3c653ec4-4e4c-4820-8127-49e3889cad99"
],
"servicePrincipalType": "Application",
"tags": [
"WindowsAzureActiveDirectoryIntegratedApp"
],
"tokenEncryptionKeyId": null,
"samlSingleSignOnSettings": null,
"verifiedPublisher": {
"displayName": null,
"verifiedPublisherId": null,
"addedDateTime": null
},
"addIns": [],
"appRoles": [
{
"allowedMemberTypes": [
"User"
],
"displayName": "msiam_access",
"id": "8b292bda-39b6-4b77-849e-887565235bb0",
"isEnabled": true,
"description": "msiam_access",
"value": null,
"origin": "Application"
}
],
"info": {
"logoUrl": null,
"marketingUrl": null,
"privacyStatementUrl": null,
"supportUrl": null,
"termsOfServiceUrl": null
},
"keyCredentials": [],
"oauth2PermissionScopes": [
{
"adminConsentDescription": "Allow the application to access Azure AD SAML Toolkit on behalf of the signed-in user.",
"adminConsentDisplayName": "Access Azure AD SAML Toolkit",
"id": "00e7ef81-4deb-41d7-9ee3-90d4eba1e991",
"isEnabled": true,
"type": "User",
"userConsentDescription": "Allow the application to access Azure AD SAML Toolkit on your behalf.",
"userConsentDisplayName": "Access Azure AD SAML Toolkit",
"value": "user_impersonation"
}
],
"passwordCredentials": []
}
}
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários