Trying to set up a shortcut to directly open an Appstream URL

0

Trying to set up a shortcut to directly open an Appstream URL as described here: https://docs.aws.amazon.com/appstream2/latest/developerguide/redirect-streaming-session-from-web-to-client.html. The shortcut is pointing to this path: amazonappstream:https://vanguardesf.oktapreview.com/home/amazon_appstream/<unique string>

The unencoded URL is allowed by the AppStream 2.0 client (trusted domain setting in the registry). Expecting the Appstream client to open and automatically connect to the URL. The client opens but it isn't using the URL in the shortcut. It is using the start URL from the registry, and it is not connecting automatically. Any ideas?

asked a year ago662 views
1 Answer
-2

Hello,

I understand that you are trying to set up a shortcut to directly open an Appstream URL by the shortcut is pointing to this path: amazonappstream:https://vanguardesf.oktapreview.com/home/amazon_appstream/<unique string>.

Also as mentioned the unencoded URL is allowed by the AppStream 2.0 client (trusted domain setting in the registry) expecting the Appstream client to open and automatically connect to the URL. The client opens but it isn't using the URL in the shortcut. It is using the start URL from the registry, and it is not connecting automatically.

It's mentioned in the documentation that to add the following prefix for the custom AppStream 2.0 client handler to the streaming URL: amazonappstream:

Together, the prefix and streaming URL are formatted as follows: amazonappstream:base64encoded(streamingURL) and please note that the URL used here needs to be base64 encoded, and must include the HTTPS part. Please refer the below document.

Redirect a Streaming Session from the Web Browser to the AppStream 2.0 Client - https://docs.aws.amazon.com/appstream2/latest/developerguide/redirect-streaming-session-from-web-to-client.html

Run the following PowerShell command to convert the streamingURL into a Base64 encoded URL. Replace URL with the URL copied in step 3: [Convert]::ToBase64String([System.Text.Encoding]::Unicode.GetBytes("URL"))

Also, Instead of converting embed link URL into a Base64 encoded via powerShell command, you can use the he below third party link to convert the link URL into a Base64 encoded URL.

[+] https://base64.guru/converter/encode/url

For example the url should be in the below format.

amazonappstream:aHR0cHM6LG8FQzJBTUFaLThRMVZVNEGuSXRwGW5GGS5jb20vGWRmcG8scG8pZHBpbml0aWF0ZWRzaWdub24uGXNweD8 i.e (amazonappstream:base64encoded(streamingURL))

Additionally, In order to set the StartURL in the AppStream 2.0 Client, you will need to execute the following script in PowerShell as an administrator, replacing 'https://www.example.com ' with your own StartURL.

$registryPath="HKLM:\Software\Amazon\AppStream Client"
    New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force
    New-ItemProperty -Path $registryPath -Name "StartUrl" -Value "https://www.example.com   " -PropertyType String -Force | Out-Null

Once this script has been executed, I would suggest re-opening the AppStream Client and attempting to connect.

Thanks,

answered a year ago
  • I went to this website but it didn't work https://base64.guru/converter/encode/url I ran the powershell command and used the generated string for my shortcut. When I double clicked the shortcut, the appstream client opened with the correct URL, but it didn't automatically connect to the URL, and the connect button was greyed out.

  • It is not connecting and the connect button is greyed out. Please help.

  • This didn't work. Downvoting.

You are not logged in. Log in to post an answer.

A good answer clearly answers the question and provides constructive feedback and encourages professional growth in the question asker.

Guidelines for Answering Questions