Principal
Principal is the Schema for the Principals API.
TypeMR
Providerprovider-azuread
Groupserviceprincipals.azuread.upbound.io
Scopecluster
Versionv1beta1

1apiVersion: serviceprincipals.azuread.upbound.io/v1beta1

2kind: Principal

apiVersion
string
kind
string
metadata
object
spec
object

PrincipalSpec defines the desired state of Principal

deletionPolicy
string
forProvider
required
object

(No description available)

accountEnabled
boolean
alternativeNames
array

A set of alternative names, used to retrieve service principals by subscription, identify resource group and full resource ids for managed identities. A list of alternative names, used to retrieve service principals by subscription, identify resource group and full resource ids for managed identities

appRoleAssignmentRequired
boolean
applicationId
string
applicationIdRef
object

Reference to a Application in applications to populate applicationId.

name
required
string
policy
object

Policies for referencing.

resolution
string
resolve
string
applicationIdSelector
object

Selector for a Application in applications to populate applicationId.

matchControllerRef
boolean
matchLabels
object
policy
object

Policies for selection.

resolution
string
resolve
string
description
string
featureTags
array

A feature_tags block as described below. Cannot be used together with the tags property. Block of features to configure for this service principal using tags

customSingleSignOn
boolean
enterprise
boolean
gallery
boolean
hide
boolean
loginUrl
string
notes
string
notificationEmailAddresses
array

A set of email addresses where Azure AD sends a notification when the active certificate is near the expiration date. This is only for the certificates used to sign the SAML token issued for Azure AD Gallery applications. List of email addresses where Azure AD sends a notification when the active certificate is near the expiration date. This is only for the certificates used to sign the SAML token issued for Azure AD Gallery applications

owners
array

A set of object IDs of principals that will be granted ownership of the service principal. Supported object types are users or service principals. By default, no owners are assigned. A list of object IDs of principals that will be granted ownership of the service principal

preferredSingleSignOnMode
string
samlSingleSignOn
array

A saml_single_sign_on block as documented below. Settings related to SAML single sign-on

relayState
string
tags
array

A set of tags to apply to the service principal for configuring specific behaviours of the service principal. Note that these are not provided for use by practitioners. Cannot be used together with the feature_tags block. A set of tags to apply to the service principal

useExisting
boolean
initProvider
object

THIS IS A BETA FIELD. It will be honored unless the Management Policies feature flag is disabled. InitProvider holds the same fields as ForProvider, with the exception of Identifier and other resource reference fields. The fields that are in InitProvider are merged into ForProvider when the resource is created. The same fields are also added to the terraform ignore_changes hook, to avoid updating them after creation. This is useful for fields that are required on creation, but we do not desire to update them after creation, for example because of an external controller is managing them, like an autoscaler.

accountEnabled
boolean
alternativeNames
array

A set of alternative names, used to retrieve service principals by subscription, identify resource group and full resource ids for managed identities. A list of alternative names, used to retrieve service principals by subscription, identify resource group and full resource ids for managed identities

appRoleAssignmentRequired
boolean
description
string
featureTags
array

A feature_tags block as described below. Cannot be used together with the tags property. Block of features to configure for this service principal using tags

customSingleSignOn
boolean
enterprise
boolean
gallery
boolean
hide
boolean
loginUrl
string
notes
string
notificationEmailAddresses
array

A set of email addresses where Azure AD sends a notification when the active certificate is near the expiration date. This is only for the certificates used to sign the SAML token issued for Azure AD Gallery applications. List of email addresses where Azure AD sends a notification when the active certificate is near the expiration date. This is only for the certificates used to sign the SAML token issued for Azure AD Gallery applications

owners
array

A set of object IDs of principals that will be granted ownership of the service principal. Supported object types are users or service principals. By default, no owners are assigned. A list of object IDs of principals that will be granted ownership of the service principal

preferredSingleSignOnMode
string
samlSingleSignOn
array

A saml_single_sign_on block as documented below. Settings related to SAML single sign-on

relayState
string
tags
array

A set of tags to apply to the service principal for configuring specific behaviours of the service principal. Note that these are not provided for use by practitioners. Cannot be used together with the feature_tags block. A set of tags to apply to the service principal

useExisting
boolean
managementPolicies
array

THIS IS A BETA FIELD. It is on by default but can be opted out through a Crossplane feature flag. ManagementPolicies specify the array of actions Crossplane is allowed to take on the managed and external resources. This field is planned to replace the DeletionPolicy field in a future release. Currently, both could be set independently and non-default values would be honored if the feature flag is enabled. If both are custom, the DeletionPolicy field will be ignored. See the design doc for more information: https://github.com/crossplane/crossplane/blob/499895a25d1a1a0ba1604944ef98ac7a1a71f197/design/design-doc-observe-only-resources.md?plain=1#L223 and this one: https://github.com/crossplane/crossplane/blob/444267e84783136daa93568b364a5f01228cacbe/design/one-pager-ignore-changes.md

providerConfigRef
object

ProviderConfigReference specifies how the provider that will be used to create, observe, update, and delete this managed resource should be configured.

name
required
string
policy
object

Policies for referencing.

resolution
string
resolve
string
publishConnectionDetailsTo
object

PublishConnectionDetailsTo specifies the connection secret config which contains a name, metadata and a reference to secret store config to which any connection details for this managed resource should be written. Connection details frequently include the endpoint, username, and password required to connect to the managed resource.

configRef
object

SecretStoreConfigRef specifies which secret store config should be used for this ConnectionSecret.

name
required
string
policy
object

Policies for referencing.

resolution
string
resolve
string
metadata
object

Metadata is the metadata for connection secret.

annotations
object
labels
object
type
string
name
required
string
writeConnectionSecretToRef
object

WriteConnectionSecretToReference specifies the namespace and name of a Secret to which any connection details for this managed resource should be written. Connection details frequently include the endpoint, username, and password required to connect to the managed resource. This field is planned to be replaced in a future release in favor of PublishConnectionDetailsTo. Currently, both could be set independently and connection details would be published to both without affecting each other.

name
required
string
namespace
required
string
status
object

PrincipalStatus defines the observed state of Principal.

atProvider
object

(No description available)

accountEnabled
boolean
alternativeNames
array

A set of alternative names, used to retrieve service principals by subscription, identify resource group and full resource ids for managed identities. A list of alternative names, used to retrieve service principals by subscription, identify resource group and full resource ids for managed identities

appRoleAssignmentRequired
boolean
appRoleIds
object
appRoles
array

A list of app roles published by the associated application, as documented below. For more information official documentation.

allowedMemberTypes
array

Specifies whether this app role definition can be assigned to users and groups, or to other applications (that are accessing this application in a standalone scenario). Possible values are: User and Application, or both.

description
string
displayName
string
enabled
boolean
id
string
value
string
applicationId
string
applicationTenantId
string
description
string
displayName
string
featureTags
array

A feature_tags block as described below. Cannot be used together with the tags property. Block of features to configure for this service principal using tags

customSingleSignOn
boolean
enterprise
boolean
gallery
boolean
hide
boolean
homepageUrl
string
id
string
loginUrl
string
logoutUrl
string
notes
string
notificationEmailAddresses
array

A set of email addresses where Azure AD sends a notification when the active certificate is near the expiration date. This is only for the certificates used to sign the SAML token issued for Azure AD Gallery applications. List of email addresses where Azure AD sends a notification when the active certificate is near the expiration date. This is only for the certificates used to sign the SAML token issued for Azure AD Gallery applications

oauth2PermissionScopeIds
object
oauth2PermissionScopes
array

A list of OAuth 2.0 delegated permission scopes exposed by the associated application, as documented below.

adminConsentDescription
string
adminConsentDisplayName
string
enabled
boolean
id
string
type
string
userConsentDescription
string
userConsentDisplayName
string
value
string
objectId
string
owners
array

A set of object IDs of principals that will be granted ownership of the service principal. Supported object types are users or service principals. By default, no owners are assigned. A list of object IDs of principals that will be granted ownership of the service principal

preferredSingleSignOnMode
string
redirectUris
array

A list of URLs where user tokens are sent for sign-in with the associated application, or the redirect URIs where OAuth 2.0 authorization codes and access tokens are sent for the associated application. The URLs where user tokens are sent for sign-in with the associated application, or the redirect URIs where OAuth 2.0 authorization codes and access tokens are sent for the associated application

samlMetadataUrl
string
samlSingleSignOn
array

A saml_single_sign_on block as documented below. Settings related to SAML single sign-on

relayState
string
servicePrincipalNames
array

A list of identifier URI(s), copied over from the associated application. A list of identifier URI(s), copied over from the associated application

signInAudience
string
tags
array

A set of tags to apply to the service principal for configuring specific behaviours of the service principal. Note that these are not provided for use by practitioners. Cannot be used together with the feature_tags block. A set of tags to apply to the service principal

type
string
useExisting
boolean
conditions
array

Conditions of the resource.

lastTransitionTime
required
string
message
string
reason
required
string
status
required
string
type
required
string
Discover the building blocks for your internal cloud platform.
© 2026 Upbound, Inc.
Solutions
Learn
Company
Community
More