Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Contém detalhes sobre a identidade visual padrão da organização. Herda de organizationalBrandingProperties.
As organizações podem personalizar suas páginas de entrada do Microsoft Entra, que aparecem quando os usuários entram nos aplicativos específicos do locatário de sua organização ou quando o Microsoft Entra ID identifica o locatário do usuário pelo nome de usuário. Um desenvolvedor também pode ler as informações de marca da empresa e personalizar sua experiência de aplicativo para adaptá-la especificamente para o usuário conectado usando a identidade visual de sua empresa.
Você não pode alterar o idioma da configuração original. No entanto, as empresas podem adicionar marcas diferentes com base na localidade. Para identidade visual específica do idioma, consulte o objeto organizationalBrandingLocalization .
Observação
Para adicionar a identidade visual personalizada, você deve ter licenças do Microsoft Entra ID P1 ou P2, Premium 2 ou licenças do Office 365 (para aplicativos do Office 365). Para obter mais informações sobre licenciamento e edições, consulte Inscreva-se no Microsoft Entra ID P1 ou P2.
As edições P1 ou P2 do Microsoft Entra ID estão disponíveis para clientes na China que usam a instância mundial do Microsoft Entra ID. No momento, não há suporte para as edições P1 ou P2 do Microsoft Entra ID no serviço do Azure operado pela 21Vianet na China. Para obter mais informações, fale conosco usando o Fórum do Microsoft Entra.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Get | organizationalBranding | Leia as propriedades e relações de um objeto organizationalBranding . |
| Atualizar | Nenhum(a) | Atualize as propriedades de um objeto organizationalBranding . |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| backgroundColor | Cadeia de caracteres | Cor que aparecerá no lugar da imagem de fundo em conexões de baixa largura de banda. Recomendamos que você use a cor primária do logotipo da faixa ou a cor de sua organização. Especifique isso em formato hexadecimal, por exemplo, branco é #FFFFFF. Herdado de organizationalBrandingProperties. |
| backgroundImage | Stream | Imagem que aparece como o plano de fundo da página de entrada. Os tipos permitidos são PNG ou JPEG, não menores que 300 KB e não maiores que 1920 × 1080 pixels. Uma imagem menor reduzirá os requisitos de largura de banda e fará com que o carregamento da página seja mais rápido. Herdado de organizationalBrandingProperties. Requer $select recuperação. |
| backgroundImageRelativeUrl | Cadeia de caracteres | Uma URL relativa para a propriedade backgroundImage que é combinada com uma URL base da CDN da cdnList para fornecer a versão servida por uma CDN. Somente leitura. Herdado de organizationalBrandingProperties. |
| bannerLogo | Stream | Uma versão em faixa do logotipo da sua empresa que aparece na página de entrada. Os tipos permitidos são PNG ou JPEG, com no máximo 245 x 36 pixels. Recomendamos o uso de uma imagem transparente sem preenchimento ao redor do logotipo. Herdado de organizationalBrandingProperties. Requer $select recuperação. |
| bannerLogoRelativeUrl | Cadeia de caracteres | Uma URL relativa para a propriedade bannerLogo que é combinada com uma URL base CDN da cdnList para fornecer a versão somente leitura servida por uma CDN. Somente leitura. Herdado de organizationalBrandingProperties. |
| cdnList | String collection | Uma lista de URLs base para todos os provedores de CDN disponíveis que estão servindo os ativos do recurso atual. Vários provedores de CDN são usados ao mesmo tempo para alta disponibilidade de solicitações de leitura. Somente leitura. Herdado de organizationalBrandingProperties. |
| contentCustomization | contentCustomization | Representa as opções de conteúdo a serem personalizadas em todo o fluxo de autenticação de um locatário. OBSERVAÇÃO: Com suporte de ID externa do Microsoft Entra somente em locatários externos. |
| customAccountResetCredentialsUrl | Cadeia de caracteres | Uma URL personalizada para redefinir as credenciais da conta. Essa URL deve estar no formato ASCII ou caracteres não ASCII devem ser codificados por URL e não exceder 128 caracteres. Herdado de organizationalBrandingProperties. |
| customCannotAccessYourAccountText | Cadeia de caracteres | Uma cadeia de caracteres para substituir o texto padrão do hiperlink "Não consegue acessar sua conta?" redefinição de senha de autoatendimento (SSPR) na página de entrada. Este texto deve estar no formato Unicode e não exceder 256 caracteres. Herdado de organizationalBrandingProperties. |
| customCannotAccessYourAccountUrl | Cadeia de caracteres | Uma URL personalizada para substituir a URL padrão do hiperlink "Não consegue acessar sua conta?" da SSPR (redefinição de senha de autoatendimento) na página de entrada. Essa URL deve estar no formato ASCII ou caracteres não ASCII devem ser codificados por URL e não exceder 128 caracteres. NÃO USE. Em vez disso, use customAccountResetCredentialsUrl . Herdado de organizationalBrandingProperties. |
| customCSS | Stream | Estilo CSS exibido na página de entrada. O formato permitido é somente .css formato e não é maior que 25 KB. Herdado de organizationalBrandingProperties. |
| customCSSRelativeUrl | Cadeia de caracteres | Uma URL relativa para a propriedade customCSS que é combinada com uma URL base da CDN da cdnList para fornecer a versão servida por uma CDN. Somente leitura. Herdado de organizationalBrandingProperties. |
| customForgotMyPasswordText | Cadeia de caracteres | Uma cadeia de caracteres para substituir o texto padrão do hiperlink "Esqueci minha senha" no formulário de entrada. Este texto deve estar no formato Unicode e não exceder 256 caracteres. Herdado de organizationalBrandingProperties. |
| customPrivacyAndCookiesText | Cadeia de caracteres | Uma cadeia de caracteres para substituir o texto padrão do hiperlink "Privacidade e cookies" no rodapé. Este texto deve estar no formato Unicode e não exceder 256 caracteres. Herdado de organizationalBrandingProperties. |
| customPrivacyAndCookiesUrl | Cadeia de caracteres | Uma URL personalizada para substituir a URL padrão do hiperlink "Privacidade e Cookies" no rodapé. Essa URL deve estar no formato ASCII ou caracteres não ASCII devem ser codificados por URL e não exceder 128 caracteres. Herdado de organizationalBrandingProperties. |
| customResetItNowText | Cadeia de caracteres | Uma cadeia de caracteres para substituir o texto padrão do hiperlink "redefinir agora" no formulário de entrada. Este texto deve estar no formato Unicode e não exceder 256 caracteres. NÃO USE: No momento, não há suporte para a personalização do texto do hiperlink "redefinir agora". Herdado de organizationalBrandingProperties. |
| customTermsOfUseText | Cadeia de caracteres | Uma cadeia de caracteres para substituir o texto padrão do hiperlink "Termos de uso" no rodapé. Este texto deve estar no formato Unicode e não exceder 256 caracteres. Herdado de organizationalBrandingProperties. |
| customTermsOfUseUrl | Cadeia de caracteres | Uma URL personalizada para substituir a URL padrão do hiperlink "Termos de uso" no rodapé. Essa URL deve estar no formato ASCII ou caracteres não ASCII devem ser codificados por URL e não exceder 128 caracteres. Herdado de organizationalBrandingProperties. |
| favicon | Stream | Um ícone personalizado (favicon) para substituir um favicon padrão de produto da Microsoft em um locatário do Microsoft Entra. Herdado de organizationalBrandingProperties. |
| faviconRelativeUrl | Cadeia de caracteres | Um url relativo para o favicon acima que é combinado com um URL base CDN do cdnList para fornecer a versão servida por um CDN. Somente leitura. Herdado de organizationalBrandingProperties. |
| headerBackgroundColor | Cadeia de caracteres | A cor RGB a ser aplicada para personalizar a cor do cabeçalho. Herdado de organizationalBrandingProperties. |
| headerLogo | Stream | Um logotipo da empresa que aparece no cabeçalho da página de entrada. Os tipos permitidos são PNG ou JPEG, com tamanho não maior que 245 x 36 pixels. Recomendamos o uso de uma imagem transparente sem preenchimento ao redor do logotipo. Herdado de organizationalBrandingProperties. |
| headerLogoRelativeUrl | Cadeia de caracteres | Uma URL relativa para a propriedade headerLogo que é combinada com uma URL base CDN da cdnList para fornecer a versão somente leitura atendida por uma CDN. Somente leitura. Herdado de organizationalBrandingProperties. |
| id | Cadeia de caracteres | Um identificador que representa a localidade especificada usando nomes de cultura. Os nomes de cultura seguem o padrão RFC 1766 no formato "languagecode2-country/regioncode2", onde "languagecode2" é um código minúsculo de duas letras derivado da ISO 639-1 e "country/regioncode2" é um código maiúsculo de duas letras derivado da ISO 3166. Por exemplo, o inglês dos EUA é en-US. A ID para o /branding padrão é sempre Tipos 0 de cadeia de caracteres ou default. Somente leitura. OBSERVAÇÃO: No momento, não há suporte para várias marcas para uma única localidade. Herdado de organizationalBrandingProperties. |
| loginPageLayoutConfiguration | loginPageLayoutConfiguration | Representa a configuração de layout a ser exibida na página de logon de um locatário. Herdado de organizationalBrandingProperties. |
| loginPageTextVisibilitySettings | loginPageTextVisibilitySettings | Representa os vários textos que podem ser ocultos na página de logon de um locatário. Herdado de organizationalBrandingProperties. |
| signInPageText | Cadeia de caracteres | Texto que aparece na parte inferior da caixa de entrada. Você pode usar isso para comunicar informações adicionais, como o número de telefone ao suporte técnico ou uma declaração legal. Este texto deve ser Unicode e não exceder 1024 caracteres. Herdado de organizationalBrandingProperties. |
| squareLogo | Stream | Uma versão quadrada do logotipo da sua empresa que aparece nas experiências de configuração inicial pelo usuário (OOBE) do Windows 10 e quando o Windows Autopilot está habilitado para implantação. Os tipos permitidos são PNG ou JPEG, com no máximo 240 x 240 pixels e no máximo 10 KB de tamanho. Recomendamos o uso de uma imagem transparente sem preenchimento ao redor do logotipo. Herdado de organizationalBrandingProperties. Requer $select recuperação. |
| squareLogoRelativeUrl | Cadeia de caracteres | Uma URL relativa para a propriedade squareLogo que é combinada com uma URL base CDN da cdnList para fornecer a versão servida por uma CDN. Somente leitura. Herdado de organizationalBrandingProperties. |
| quadradoLogotipoEscuro | Stream | Uma versão quadrada e escura do logotipo da sua empresa que aparece nas experiências de configuração inicial pelo usuário (OOBE) do Windows 10 e quando o Windows Autopilot está habilitado para implantação. Os tipos permitidos são PNG ou JPEG, com tamanho não maior que 240 x 240 pixels e não superior a 10 KB. Recomendamos o uso de uma imagem transparente sem preenchimento ao redor do logotipo. Herdado de organizationalBrandingProperties. |
| squareLogoDarkRelativeUrl | Cadeia de caracteres | Uma URL relativa para a propriedade squareLogoDark que é combinada com uma URL base CDN da cdnList para fornecer a versão servida por uma CDN. Somente leitura. Herdado de organizationalBrandingProperties. |
| usernameHintText | Cadeia de caracteres | Cadeia de caracteres que aparece como a dica na caixa de texto do nome de usuário na tela de entrada. Este texto deve ser um Unicode, sem links ou código, e não pode exceder 64 caracteres. Herdado de organizationalBrandingProperties. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| localizações | coleção organizationalBrandingLocalization | Adicionar marcas diferentes com base em uma localidade. |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"@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"
}}