As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Personalize a marca no WorkSpaces Personal A Amazon WorkSpaces permite que você crie uma WorkSpaces experiência familiar para seus usuários usando APIs para personalizar a aparência da sua página de login com seu WorkSpace próprio logotipo de marca, informações de suporte de TI, link de senha esquecida e mensagem de login. Sua marca será exibida para seus usuários na página de WorkSpace login, em vez da WorkSpaces marca padrão. Os seguintes clientes são aceitos: + Windows + Linux + Android + MacOS + iOS + Web Access ## Importar marca personalizada Para importar a personalização de marca do cliente, use a ação `ImportClientBranding`, que inclui os elementos a seguir. Consulte a [referência ImportClientBranding da API](https://docs.aws.amazon.com/workspaces/latest/api/API_ImportClientBranding.html) para obter mais informações. **Importante** Os atributos da marca do cliente são voltados para o público. Não inclua informações confidenciais. Dependendo se seus diretórios estão usando o fluxo de login de usuário antigo ou novo, seus usuários verão os atributos personalizados da marca do cliente, conforme mostrado nas capturas de tela abaixo. | | | | --- |--- | | ![\[WorkSpaces tela de login do cliente - Fluxo de login antigo\]](http://docs.aws.amazon.com/pt_br/workspaces/latest/adminguide/images/client-cobranding-legacy.png) | ![\[WorkSpaces tela de login do cliente - Novo fluxo de login\]](http://docs.aws.amazon.com/pt_br/workspaces/latest/adminguide/images/client-cobranding-new.png) | 1. Link de suporte 1. Logo 1. Link de esquecimento de senha 1. Mensagem de login **Elementos de marca personalizados** | Elemento da marca | Description | Requisitos e recomendações | | --- | --- | --- | | Link de suporte | Permite que você especifique um link de e-mail de suporte para os usuários entrarem em contato para obter ajuda WorkSpaces. Você pode usar o atributo SupportEmail ou fornecer um link para a página de suporte usando o atributo SupportLink. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/workspaces/latest/adminguide/customize-branding.html) | | Logo | Permite que você personalize o logotipo da organização usando o atributo Logo. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/workspaces/latest/adminguide/customize-branding.html) | | Link de esquecimento de senha | Permite adicionar um endereço da web usando o ForgotPasswordLink atributo que os usuários podem acessar se esquecerem a senha WorkSpace. | Restrições de comprimento: comprimento mínimo 1. Tamanho máximo de 200. | | Mensagem de login | Permite que você personalize uma mensagem usando o atributo LoginMessage na tela de login. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/workspaces/latest/adminguide/customize-branding.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/workspaces/latest/adminguide/customize-branding.html) | Veja a seguir exemplos de trechos de código para uso. ImportClientBranding ### AWS CLI versão 2 **Atenção** A importação de marcas personalizadas substitui os atributos, dentro da plataforma, que você especifica com seus dados personalizados. Ela também substitui os atributos que você não especifica pelos valores padrão de atributos de marca personalizados. Você deve incluir os dados de qualquer atributo que não deseja substituir. ``` aws workspaces import-client-branding \ --cli-input-json file://~/Downloads/import-input.json \ --region us-west-2 ``` O arquivo JSON de importação deve ter uma aparência semelhante à seguinte amostra de código: ``` { "ResourceId": "", "DeviceTypeOsx": { "Logo": "iVBORw0KGgoAAAANSUhEUgAAAAIAAAACCAYAAABytg0kAAAAC0lEQVR42mNgQAcAABIAAeRVjecAAAAASUVORK5CYII=", "ForgotPasswordLink": "https://amazon.com/", "SupportLink": "https://amazon.com/", "LoginMessage": { "en_US": "Hello!!" } } } ``` O exemplo de trecho de código Java a seguir converte a imagem do logotipo em uma string codificada em base64: ``` // Read image as BufferImage BufferedImage bi = ImageIO.read(new File("~/Downloads/logo.png")); // convert BufferedImage to byte[] ByteArrayOutputStream baos = new ByteArrayOutputStream(); ImageIO.write(bi, "png", baos); byte[] bytes = baos.toByteArray(); //convert byte[] to base64 format and print it String bytesBase64 = Base64.encodeBase64String(bytes); System.out.println(bytesBase64); ``` O exemplo de trecho de código Python a seguir converte a imagem do logotipo em uma string codificada em base64: ``` # Read logo into base64-encoded string with open("~/Downloads/logo.png", "rb") as image_file: f = image_file.read() base64_string = base64.b64encode(f) print(base64_string) ``` ### Java **Atenção** A importação de marcas personalizadas substitui os atributos, dentro da plataforma, que você especifica com seus dados personalizados. Ela também substitui os atributos que você não especifica pelos valores padrão de atributos de marca personalizados. Você deve incluir os dados de qualquer atributo que não deseja substituir. ``` // Create WS Client WorkSpacesClient client = WorkSpacesClient.builder().build(); // Read image as BufferImage BufferedImage bi = ImageIO.read(new File("~/Downloads/logo.png")); // convert BufferedImage to byte[] ByteArrayOutputStream baos = new ByteArrayOutputStream(); ImageIO.write(bi, "png", baos); byte[] bytes = baos.toByteArray(); // Create import attributes for the plateform DefaultImportClientBrandingAttributes attributes = DefaultImportClientBrandingAttributes.builder() .logo(SdkBytes.fromByteArray(bytes)) .forgotPasswordLink("https://aws.amazon.com/") .supportLink("https://aws.amazon.com/") .build(); // Create import request ImportClientBrandingRequest request = ImportClientBrandingRequest.builder() .resourceId("") .deviceTypeOsx(attributes) .build(); // Call ImportClientBranding API ImportClientBrandingResponse response = client.importClientBranding(request); ``` ### Python **Atenção** A importação de marcas personalizadas substitui os atributos, dentro da plataforma, que você especifica com seus dados personalizados. Ela também substitui os atributos que você não especifica pelos valores padrão de atributos de marca personalizados. Você deve incluir os dados de qualquer atributo que não deseja substituir. ``` import boto3 # Read logo into bytearray with open("~/Downloads/logo.png", "rb") as image_file: f = image_file.read() bytes = bytearray(f) # Create WorkSpaces client client = boto3.client('workspaces') # Call import API response = client.import_client_branding( ResourceId='', DeviceTypeOsx={ 'Logo': bytes, 'SupportLink': 'https://aws.amazon.com/', 'ForgotPasswordLink': 'https://aws.amazon.com/', 'LoginMessage': { 'en_US': 'Hello!!' } } ) ``` ### PowerShell ``` #Requires -Modules @{ ModuleName="AWS.Tools.WorkSpaces"; ModuleVersion="4.1.56"} # Specify Image Path $imagePath = "~/Downloads/logo.png" # Create Byte Array from image file $imageByte = ([System.IO.File]::ReadAllBytes($imagePath)) # Call import API Import-WKSClientBranding -ResourceId ` -DeviceTypeLinux_LoginMessage @{en_US="Hello!!"} ` -DeviceTypeLinux_Logo $imageByte ` -DeviceTypeLinux_ForgotPasswordLink "https://aws.amazon.com/" ` -DeviceTypeLinux_SupportLink "https://aws.amazon.com/" ``` Para visualizar a página de login, inicie o WorkSpaces aplicativo ou a página de login na web. **nota** As alterações podem levar até um minuto para serem exibidas. ## Descreva a marca personalizada Para ver os detalhes da personalização da marca do cliente que você tem atualmente, use a ação `DescribeCustomBranding`. Veja a seguir um exemplo de script para uso DescribeClientBranding. Consulte a [referência DescribeClientBranding da API](https://docs.aws.amazon.com/workspaces/latest/api/API_DescribeClientBranding.html) para obter mais informações. ``` aws workspaces describe-client-branding \ --resource-id \ --region us-west-2 ``` ## Excluir marca personalizada Para excluir a personalização da marca do cliente, use a ação `DeleteCustomBranding`. Veja a seguir um exemplo de script para uso DeleteClientBranding. Consulte a [referência DeleteClientBranding da API](https://docs.aws.amazon.com/workspaces/latest/api/API_DeleteClientBranding.html) para obter mais informações. ``` aws workspaces delete-client-branding \ --resource-id \ --platforms DeviceTypeAndroid DeviceTypeIos \ --region us-west-2 ``` **nota** As alterações podem levar até um minuto para serem exibidas.