Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Passen Sie das Branding in WorkSpaces Personal an

Amazon WorkSpaces ermöglicht es Ihnen, Ihren Benutzern ein vertrautes WorkSpaces Erlebnis zu bieten, indem Sie APIs verwenden, um das Erscheinungsbild Ihrer Anmeldeseite mit Ihrem WorkSpace eigenen Branding-Logo, IT-Supportinformationen, dem Link zum vergessenen Passwort und der Anmeldenachricht anzupassen. Ihr Branding wird Ihren Benutzern auf ihrer WorkSpace Anmeldeseite angezeigt und nicht das WorkSpaces Standard-Branding.

Folgende Clients werden unterstützt:

Importieren eines benutzerdefinierten Brandings

Verwenden Sie die Aktion ImportClientBranding, die die folgenden Elemente umfasst, um Ihre Client-Branding-Anpassung zu importieren. Weitere Informationen finden Sie in der ImportClientBranding API-Referenz.

Im Folgenden finden Sie Beispielcodefragmente zur Verwendung. ImportClientBranding

AWS CLI Version 2

aws workspaces import-client-branding \
--cli-input-json file://~/Downloads/import-input.json \
--region us-west-2

Die Import-JSON-Datei sollte wie folgt aussehen:

{
    "ResourceId": "<directory-id>",
    "DeviceTypeOsx": {
        "Logo": "iVBORw0KGgoAAAANSUhEUgAAAAIAAAACCAYAAABytg0kAAAAC0lEQVR42mNgQAcAABIAAeRVjecAAAAASUVORK5CYII=",
        "ForgotPasswordLink": "https://amazon.com/",
        "SupportLink": "https://amazon.com/",
        "LoginMessage": {
            "en_US": "Hello!!"
        }
    }
}

Das folgende Beispiel für einen Java-Codeausschnitt konvertiert das Logobild in eine Base64-kodierte Zeichenfolge:

// 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);

Der folgende Python-Beispielcodeausschnitt konvertiert das Logobild in eine Base64-kodierte Zeichenfolge:

# 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/"

Um eine Vorschau der Anmeldeseite anzuzeigen, starten Sie die WorkSpaces Anwendung oder die Web-Anmeldeseite.

Beschreiben des benutzerdefinierten Brandings

Verwenden Sie die Aktion DescribeCustomBranding, um die Details der Anpassung des Client-Brandings anzuzeigen, die Sie derzeit verwenden. Im Folgenden finden Sie das Beispielskript für die Verwendung DescribeClientBranding. Weitere Informationen finden Sie in der DescribeClientBranding API-Referenz.

aws workspaces describe-client-branding \
--resource-id <directory-id> \
--region us-west-2

Löschen des benutzerdefinierten Brandings

Verwenden Sie die Aktion DeleteCustomBranding, um Ihre Client-Branding-Anpassung zu löschen. Im Folgenden finden Sie das Beispielskript zur Verwendung DeleteClientBranding. Weitere Informationen finden Sie in der DeleteClientBranding API-Referenz.

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