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 identidade visual no WorkSpaces Personal

Com o Amazon WorkSpaces, você pode criar uma experiência familiar para os usuários usando APIs para personalizar a aparência da página de login do WorkSpace com seu próprio logotipo de marca, informações de suporte de TI, link de senha esquecida e mensagem de login. Sua marca será exibida para os usuários na página de login do WorkSpace, em vez da marca padrão do WorkSpaces.

Os seguintes clientes são aceitos:

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 da API ImportClientBranding para obter mais informações.

Veja a seguir exemplos de trechos de código para usar ImportClientBranding.

CLI da AWS versão 2

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": "<directory-id>",
    "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

// 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("<directory-id>")
                .deviceTypeOsx(attributes)
                .build();
                    
// Call ImportClientBranding API
ImportClientBrandingResponse response = client.importClientBranding(request);

Python

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='<directory-id>',
    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 <directory-id> `
    -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 a aplicação WorkSpaces ou a página de login na web.

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 o script de exemplo para usar DescribeClientBranding. Consulte a referência da API DescribeClientBranding para obter mais informações.

aws workspaces describe-client-branding \
--resource-id <directory-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 o script de exemplo para usar DeleteClientBranding. Consulte a referência da API DeleteClientBranding para obter mais informações.

aws workspaces delete-client-branding \ 
--resource-id <directory-id> \
--platforms DeviceTypeAndroid DeviceTypeIos \  
--region us-west-2