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 WorkSpaces Mit Amazon können Sie Ihren Benutzern ein vertrautes WorkSpaces Erlebnis bieten, indem APIs Sie das Erscheinungsbild Ihrer Anmeldeseite mit Ihrem WorkSpace eigenen Branding-Logo, IT-Supportinformationen, einem Link zum vergessenen Passwort und einer Anmeldenachricht anpassen. Ihr Branding wird Ihren Benutzern auf ihrer WorkSpace Anmeldeseite angezeigt und nicht das WorkSpaces Standard-Branding. Folgende Clients werden unterstützt: + Windows + Linux + Android + MacOS + iOS + Web Access ## 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](https://docs.aws.amazon.com/workspaces/latest/api/API_ImportClientBranding.html). **Wichtig** Die Branding-Attribute von Client sind öffentlich zugänglich. Stellen Sie sicher, dass Sie keine sensiblen Informationen verwenden. Je nachdem, ob Ihre Verzeichnisse den Anmeldevorgang für ältere oder neue Benutzer verwenden, werden Ihren Benutzern Ihre benutzerdefinierten Client-Branding-Attribute angezeigt, wie in den folgenden Screenshots dargestellt. | | | | --- |--- | | ![WorkSpaces Anmeldebildschirm für Kunden — Legacy-Anmeldeablauf](http://docs.aws.amazon.com/de_de/workspaces/latest/adminguide/images/client-cobranding-legacy.png) | ![WorkSpaces Anmeldebildschirm für Kunden — Neuer Anmeldevorgang](http://docs.aws.amazon.com/de_de/workspaces/latest/adminguide/images/client-cobranding-new.png) | 1. Support link 1. Logo 1. Link für „Passwort vergessen“ 1. Anmeldenachricht **Benutzerdefinierte Branding-Elemente** | Branding-Element | Description | Anforderungen und Empfehlungen | | --- | --- | --- | | Support link | Ermöglicht es Ihnen, einen Link zur Support-E-Mail anzugeben, an den sich Benutzer wenden können, um Hilfe bei ihren Problemen zu erhalten WorkSpaces. Sie können das SupportEmail-Attribut verwenden oder mithilfe des SupportLink-Attributs einen Link zu Ihrer Support-Seite bereitstellen. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/workspaces/latest/adminguide/customize-branding.html) | | Logo | Ermöglicht es Ihnen, das Logo Ihrer Organisation mithilfe des Logo-Attributs anzupassen. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/workspaces/latest/adminguide/customize-branding.html) | | Link für „Passwort vergessen“ | Ermöglicht das Hinzufügen einer Webadresse mithilfe des ForgotPasswordLink Attributs, zu dem Benutzer wechseln können, wenn sie ihr Passwort vergessen haben WorkSpace. | Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Höchstlänge = 200 Zeichen. | | Anmeldenachricht | Ermöglicht es Ihnen, eine Nachricht mithilfe des LoginMessage-Attributs auf dem Anmeldebildschirm anzupassen. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/workspaces/latest/adminguide/customize-branding.html) [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/workspaces/latest/adminguide/customize-branding.html) | Im Folgenden finden Sie Beispielcodefragmente zur Verwendung. ImportClientBranding ### AWS CLI Version 2 **Warnung** Beim Import von benutzerdefiniertem Branding werden die Attribute, die Sie innerhalb dieser Plattform angeben, mit Ihren benutzerdefinierten Daten überschrieben. Außerdem werden die Attribute, die Sie nicht angeben, durch Standardwerte für benutzerdefinierte Branding-Attribute überschrieben. Sie müssen die Daten für jedes Attribut angeben, das Sie nicht überschreiben möchten. ``` 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": "", "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 **Warnung** Beim Import von benutzerdefiniertem Branding werden die Attribute, die Sie innerhalb dieser Plattform angeben, mit Ihren benutzerdefinierten Daten überschrieben. Außerdem werden die Attribute, die Sie nicht angeben, durch Standardwerte für benutzerdefinierte Branding-Attribute überschrieben. Sie müssen die Daten für jedes Attribut angeben, das Sie nicht überschreiben möchten. ``` // 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 **Warnung** Beim Import von benutzerdefiniertem Branding werden die Attribute, die Sie innerhalb dieser Plattform angeben, mit Ihren benutzerdefinierten Daten überschrieben. Außerdem werden die Attribute, die Sie nicht angeben, durch Standardwerte für benutzerdefinierte Branding-Attribute überschrieben. Sie müssen die Daten für jedes Attribut angeben, das Sie nicht überschreiben möchten. ``` 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/" ``` Um eine Vorschau der Anmeldeseite anzuzeigen, starten Sie die WorkSpaces Anwendung oder die Web-Anmeldeseite. **Anmerkung** Es kann bis zu 1 Minute dauern, bis Änderungen angezeigt werden. ## 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 zur Verwendung DescribeClientBranding. Weitere Informationen finden Sie in der [ DescribeClientBranding API-Referenz](https://docs.aws.amazon.com/workspaces/latest/api/API_DescribeClientBranding.html). ``` aws workspaces describe-client-branding \ --resource-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](https://docs.aws.amazon.com/workspaces/latest/api/API_DeleteClientBranding.html). ``` aws workspaces delete-client-branding \ --resource-id \ --platforms DeviceTypeAndroid DeviceTypeIos \ --region us-west-2 ``` **Anmerkung** Es kann bis zu 1 Minute dauern, bis Änderungen angezeigt werden.