type de ressource organizationalBranding
Espace de noms: microsoft.graph
Contient des détails sur la personnalisation par défaut de l’organisation. Hérite de organizationalBrandingProperties.
Les organisations peuvent personnaliser leurs pages de connexion Microsoft Entra qui s’affichent lorsque les utilisateurs se connectent aux applications spécifiques au locataire de leur organisation, ou lorsque l’ID Microsoft Entra 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. 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
L’ajout d’une personnalisation nécessite que vous disposiez 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 à l’ID Microsoft Entra P1 ou P2.
Les éditions P1 ou P2 de Microsoft Entra ID sont disponibles pour les clients en Chine à l’aide de l’instance mondiale de Microsoft Entra ID. Les éditions P1 ou P2 d’ID Microsoft Entra 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
| Méthode | Type de retour | Description |
|---|---|---|
| Obtenir | organizationalBranding | Lisez les propriétés et les relations d’un objet organizationalBranding . |
| Mettre à jour | Aucun | Mettez à jour les propriétés d’un objet organizationalBranding . |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| backgroundColor | Chaîne | Couleur qui apparaîtra à la place de l’image d’arrière-plan dans les connexions à faible bande passante. Nous vous recommandons d’utiliser la couleur principale du logo de votre bannière ou de votre organisation. Spécifiez cela au format hexadécimal, par exemple, blanc est #FFFFFF. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. Renvoyé uniquement sur $select. |
| 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. Hérité de organizationalBrandingProperties. |
| 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 245 x 36 pixels. Nous vous recommandons d’utiliser une image transparente sans remplissage autour du logo. Hérité de organizationalBrandingProperties. Renvoyé uniquement sur $select. |
| 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. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. |
| contentCustomization | contentCustomization | Représente les options de contenu à personnaliser tout au long du flux d’authentification pour un locataire. NOTE: Pris en charge par l’ID externe Microsoft Entra dans les locataires externes uniquement. |
| 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. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. |
| 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 . Hérité de organizationalBrandingProperties. |
| customCSS | Stream | Style CSS qui s’affiche sur la page de connexion. Le format autorisé est .css format uniquement et ne dépasse pas 25 Ko. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. |
| customPrivacyAndCookiesText | Chaîne | Chaîne pour remplacer le texte de lien hypertexte « Confidentialité et cookies » par défaut dans le pied de page. Ce texte doit être au format Unicode et ne doit pas dépasser 256 caractères. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. |
| favicon | Stream | Icône personnalisée (favicon) pour remplacer un favicon de produit Microsoft par défaut sur un locataire Microsoft Entra. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. |
| headerBackgroundColor | Chaîne | Couleur RVB à appliquer pour personnaliser la couleur de l’en-tête. Hérité de organizationalBrandingProperties. |
| 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 245 x 36 pixels. Nous vous recommandons d’utiliser une image transparente sans remplissage autour du logo. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. |
| loginPageLayoutConfiguration | loginPageLayoutConfiguration | Représente la configuration de disposition à afficher sur la page de connexion d’un locataire. Hérité de organizationalBrandingProperties. |
| loginPageTextVisibilitySettings | loginPageTextVisibilitySettings | Représente les différents textes qui peuvent être masqués sur la page de connexion d’un locataire. Hérité de organizationalBrandingProperties. |
| signInPageText | Chaîne | Texte qui apparaît en bas de la zone de connexion. Vous pouvez l’utiliser 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 Unicode et ne doit pas dépasser 1 024 caractères. Hérité de organizationalBrandingProperties. |
| squareLogo | Stream | Version carrée du logo de votre entreprise qui apparaît dans les expériences OOBE (Out-of-Box Experience) windows 10 et lorsque Windows Autopilot est activé pour le déploiement. Les types autorisés 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. Hérité de organizationalBrandingProperties. Renvoyé uniquement sur $select. |
| 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. Hérité de organizationalBrandingProperties. |
| squareLogoDark | Stream | Une version sombre carrée du logo de votre entreprise qui apparaît dans les expériences OOBE (Out-of-Box Experience) de Windows 10 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. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. |
| 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. Hérité de organizationalBrandingProperties. |
Relations
| Relation | Type | Description |
|---|---|---|
| Localisations | Collection organizationalBrandingLocalization | Ajoutez une personnalisation différente en fonction d’un paramètre régional. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.organizationalBranding",
"id": "String (identifier)",
"backgroundColor": "String",
"backgroundImage": "Stream",
"backgroundImageRelativeUrl": "String",
"bannerLogo": "Stream",
"bannerLogoRelativeUrl": "String",
"cdnList": [
"String"
],
"contentCustomization": {
"@odata.type": "microsoft.graph.contentCustomization"
},
"signInPageText": "String",
"squareLogo": "Stream",
"squareLogoRelativeUrl": "String",
"squareLogoDark": "Stream",
"squareLogoDarkRelativeUrl": "String",
"usernameHintText": "String",
"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"
}}