type de ressource organizationalBrandingProperties
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Type abstrait qui expose les propriétés de configuration de la personnalisation d’un organization.
Les organisations peuvent personnaliser leurs pages de connexion Microsoft Entra qui s’affichent lorsque les utilisateurs se connectent aux applications propres au locataire de leur organization ou quand Microsoft Entra ID identifie le locataire de l’utilisateur à partir de leur nom d’utilisateur. Un développeur peut également lire les informations de personnalisation de l’entreprise et personnaliser son expérience d’application pour l’adapter spécifiquement à l’utilisateur connecté à l’aide de la personnalisation de son entreprise.
Vous ne pouvez pas modifier la langue de votre configuration d’origine telle que représentée par l’objet organizationalBranding . Toutefois, les entreprises peuvent ajouter une personnalisation différente en fonction des paramètres régionaux. Pour une personnalisation spécifique au langage, consultez l’objet organizationalBrandingLocalization .
Remarque
Pour ajouter une personnalisation, vous devez disposer de licences Microsoft Entra ID P1 ou P2, Premium 2 ou Office 365 (pour les applications Office 365). Pour plus d’informations sur les licences et les éditions, consultez S’inscrire à Microsoft Entra ID P1 ou P2.
Microsoft Entra ID éditions P1 ou P2 sont disponibles pour les clients en Chine à l’aide de la instance mondiale de Microsoft Entra ID. Microsoft Entra ID éditions P1 ou P2 ne sont actuellement pas prises en charge dans le service Azure géré par 21Vianet en Chine. Pour plus d’informations, contactez-nous à l’aide du forum Microsoft Entra.
Méthodes
Aucun.
Propriétés
| Propriété | Type | Description |
|---|---|---|
| Backgroundcolor | Chaîne | Couleur qui apparaît à la place de l’image d’arrière-plan dans les connexions à faible bande passante. Nous vous recommandons d’utiliser la couleur principale de votre logo de bannière ou de votre organization couleur. Spécifiez cela au format hexadécimal, par exemple, blanc est #FFFFFF. |
| Backgroundimage | Stream | Image qui apparaît comme arrière-plan de la page de connexion. Les types autorisés sont PNG ou JPEG au-dessus de 300 Ko et ne dépassent pas 1920 × 1 080 pixels. Une image plus petite réduit les besoins en bande passante et accélère le chargement de la page. |
| backgroundImageRelativeUrl | Chaîne | URL relative pour la propriété backgroundImage qui est combinée avec une URL de base CDN à partir de cdnList pour fournir la version servie par un CDN. En lecture seule. |
| bannerLogo | Stream | Une version de bannière du logo de votre entreprise qui s’affiche sur la page de connexion. Les types autorisés sont PNG ou JPEG ne dépassant pas 36 × 245 pixels. Nous vous recommandons d’utiliser une image transparente sans remplissage autour du logo. |
| bannerLogoRelativeUrl | Chaîne | URL relative pour la propriété bannerLogo qui est combinée avec une URL de base CDN de cdnList pour fournir la version en lecture seule servie par un CDN. En lecture seule. |
| cdnList | String collection | Liste des URL de base pour tous les fournisseurs CDN disponibles qui servent les ressources de la ressource actuelle. Plusieurs fournisseurs CDN sont utilisés en même temps pour la haute disponibilité des demandes de lecture. En lecture seule. |
| contentCustomization | contentCustomization | Représente les options de contenu à personnaliser tout au long du flux d’authentification pour un locataire. NOTE: Pris en charge par Microsoft Entra ID uniquement pour les locataires des clients. |
| customAccountResetCredentialsUrl | Chaîne | URL personnalisée pour la réinitialisation des informations d’identification du compte. Cette URL doit être au format ASCII ou les caractères non-ASCII doivent être codés url et ne pas dépasser 128 caractères. |
| customCannotAccessYourAccountText | Chaîne | Chaîne pour remplacer le texte par défaut du lien hypertexte de réinitialisation de mot de passe en libre-service (SSPR) sur la page de connexion. Ce texte doit être au format Unicode et ne doit pas dépasser 256 caractères. |
| customCannotAccessYourAccountUrl | Chaîne | URL personnalisée pour remplacer l’URL par défaut du lien hypertexte de réinitialisation de mot de passe en libre-service (SSPR) « Impossible d’accéder à votre compte ? » sur la page de connexion. Cette URL doit être au format ASCII ou les caractères non-ASCII doivent être codés url et ne pas dépasser 128 caractères. NE PAS UTILISER. Utilisez à la place customAccountResetCredentialsUrl . |
| customCSS | Stream | Style CSS qui s’affiche sur la page de connexion. Le format autorisé est .css au format uniquement et ne dépasse pas 25 Ko. |
| customCSSRelativeUrl | Chaîne | URL relative pour la propriété customCSS qui est combinée avec une URL de base CDN de cdnList pour fournir la version servie par un CDN. En lecture seule. |
| customForgotMyPasswordText | Chaîne | Chaîne pour remplacer le texte par défaut du lien hypertexte « J’ai oublié mon mot de passe » dans le formulaire de connexion. Ce texte doit être au format Unicode et ne doit pas dépasser 256 caractères. |
| customPrivacyAndCookiesText | Chaîne | Chaîne pour remplacer le texte par défaut du lien hypertexte « Confidentialité et cookies » dans le pied de page. Ce texte doit être au format Unicode et ne doit pas dépasser 256 caractères. |
| customPrivacyAndCookiesUrl | Chaîne | URL personnalisée pour remplacer l’URL par défaut du lien hypertexte « Confidentialité et cookies » dans le pied de page. Cette URL doit être au format ASCII ou les caractères non-ASCII doivent être codés url et ne pas dépasser 128 caractères. |
| customResetItNowText | Chaîne | Chaîne pour remplacer le texte par défaut du lien hypertexte « Réinitialiser maintenant » dans le formulaire de connexion. Ce texte doit être au format Unicode et ne doit pas dépasser 256 caractères. NE PAS UTILISER : La personnalisation du texte du lien hypertexte « Réinitialiser maintenant » n’est actuellement pas prise en charge. |
| customTermsOfUseText | Chaîne | Chaîne pour remplacer le texte par défaut du lien hypertexte « Conditions d’utilisation » dans le pied de page. Ce texte doit être au format Unicode et ne doit pas dépasser 256 caractères. |
| customTermsOfUseUrl | Chaîne | URL personnalisée pour remplacer l’URL par défaut du lien hypertexte « Conditions d’utilisation » dans le pied de page. Cette URL doit être au format ASCII ou les caractères non-ASCII doivent être codés url et ne pas dépasser 128 caractères. |
| Favicon | Stream | Icône personnalisée (favicon) pour remplacer un favicon de produit Microsoft par défaut sur un locataire Microsoft Entra. |
| faviconRelativeUrl | Chaîne | URL relative pour le favicon ci-dessus qui est combinée avec une URL de base CDN de cdnList pour fournir la version servie par un CDN. En lecture seule. |
| headerBackgroundColor | Chaîne | Couleur RVB à appliquer pour personnaliser la couleur de l’en-tête. |
| headerLogo | Stream | Logo de l’entreprise qui apparaît dans l’en-tête de la page de connexion. Les types autorisés sont PNG ou JPEG ne dépassant pas 36 × 245 pixels. Nous vous recommandons d’utiliser une image transparente sans remplissage autour du logo. |
| headerLogoRelativeUrl | Chaîne | URL relative pour la propriété headerLogo qui est combinée avec une URL de base CDN de cdnList pour fournir la version en lecture seule servie par un CDN. En lecture seule. |
| id | Chaîne | Identificateur qui représente les paramètres régionaux spécifiés à l’aide de noms de culture. Les noms de culture suivent la norme RFC 1766 au format « languagecode2-country/regioncode2 », où « languagecode2 » est un code à deux lettres minuscules dérivé de la norme ISO 639-1 et « country/regioncode2 » est un code majuscule à deux lettres dérivé de la norme ISO 3166. Par exemple, l’anglais américain est en-US.
L’ID du /branding par défaut est toujours les types 0 string ou default. En lecture seule. NOTE: Les personnalisations multiples pour un seul paramètre régional ne sont actuellement pas prises en charge. |
| loginPageLayoutConfiguration | loginPageLayoutConfiguration | Représente la configuration de disposition à afficher sur la page de connexion d’un locataire. |
| loginPageTextVisibilitySettings | loginPageTextVisibilitySettings | Représente les différents textes qui peuvent être masqués sur la page de connexion d’un locataire. |
| signInPageText | Chaîne | Texte qui apparaît en bas de la zone de connexion. Utilisez-le pour communiquer des informations supplémentaires, telles que le numéro de téléphone à votre support technique ou une déclaration légale. Ce texte doit être au format Unicode et ne doit pas dépasser 1 024 caractères. |
| squareLogo | Stream | Version carrée du logo de votre entreprise qui apparaît dans Windows 10 expériences OOBE (Out-of-Box Experience) et lorsque Windows Autopilot est activé pour le déploiement. Les types autorisés sont PNG ou JPEG qui ne dépassent pas 240 x 240 pixels et ne dépassent pas 10 Ko. Nous vous recommandons d’utiliser une image transparente sans remplissage autour du logo. |
| squareLogoRelativeUrl | Chaîne | URL relative pour la propriété squareLogo qui est combinée avec une URL de base CDN à partir de cdnList pour fournir la version servie par un CDN. En lecture seule. |
| squareLogoDark | Stream | Une version sombre carrée du logo de votre entreprise qui apparaît dans Windows 10 expériences OOBE (out-of-box experience) et lorsque Windows Autopilot est activé pour le déploiement. Les types autorisés sont PNG ou JPEG qui ne dépassent pas 240 x 240 pixels et ne dépassent pas 10 Ko. Nous vous recommandons d’utiliser une image transparente sans remplissage autour du logo. |
| squareLogoDarkRelativeUrl | Chaîne | URL relative pour la propriété squareLogoDark qui est combinée avec une URL de base CDN à partir de cdnList pour fournir la version servie par un CDN. En lecture seule. |
| usernameHintText | Chaîne | Chaîne qui s’affiche comme indicateur dans la zone de texte username sur l’écran de connexion. Ce texte doit être unicode, sans liens ni code, et ne peut pas dépasser 64 caractères. |
Relations
Aucun.
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.organizationalBrandingProperties",
"id": "String (identifier)",
"backgroundColor": "String",
"backgroundImage": "Stream",
"backgroundImageRelativeUrl": "String",
"bannerLogo": "Stream",
"bannerLogoRelativeUrl": "String",
"cdnList": [
"String"
],
"signInPageText": "String",
"squareLogo": "Stream",
"squareLogoRelativeUrl": "String",
"squareLogoDark": "Stream",
"squareLogoDarkRelativeUrl": "String",
"usernameHintText": "String",
"contentCustomization": {
"@odata.type": "microsoft.graph.contentCustomization"
},
"customAccountResetCredentialsUrl": "String",
"customCannotAccessYourAccountText": "String",
"customCannotAccessYourAccountUrl": "String",
"customCSS": "Stream",
"customCSSRelativeUrl": "String",
"customForgotMyPasswordText": "String",
"customPrivacyAndCookiesText": "String",
"customPrivacyAndCookiesUrl": "String",
"customResetItNowText": "String",
"customTermsOfUseText": "String",
"customTermsOfUseUrl": "String",
"favicon": "Stream",
"faviconRelativeUrl": "String",
"headerBackgroundColor": "String",
"headerLogo": "Stream",
"headerLogoRelativeUrl": "String",
"loginPageLayoutConfiguration": {
"@odata.type": "microsoft.graph.loginPageLayoutConfiguration"
},
"loginPageTextVisibilitySettings": {
"@odata.type": "microsoft.graph.loginPageTextVisibilitySettings"
}
}