type de ressource organizationalBranding
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 .
Contient des détails sur la personnalisation par défaut du organization. Hérite de organizationalBrandingProperties.
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. 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
| Méthode | Type de retour | Description |
|---|---|---|
| Obtenir organizationalBranding | organizationalBranding | Lisez les propriétés et les relations d’un objet organizationalBranding . |
| Mettre à jour organizationalBranding | Aucune | Mettez à jour les propriétés d’un objet organizationalBranding . |
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. 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. |
| 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. |
| 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 différentes options de contenu à personnaliser tout au long du flux d’authentification pour un locataire. NOTE: Pris en charge par Microsoft Entra ID pour les locataires clients uniquement. Hérité de organizationalBrandingProperties. |
| 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 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. 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. |
| 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. 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. Hérité de organizationalBrandingProperties. |
| 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 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. 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
Voici une représentation JSON de la ressource.
{
"@odata.type": "#microsoft.graph.organizationalBranding",
"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"
}
}
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour