type de ressource organizationalBrandingProperties

  • Article

Espace de noms: microsoft.graph

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 ID externe Microsoft Entra uniquement dans les locataires externes.
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"
  ],
  "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"
  }
}