Skip to content

G Suite SAML Apps and Icons

This is going to be a short post, but hopefully it helps someone. I recently started configured SAML apps in G Suite and discovered for the built-in applications the icons are not what you expect. Read on to learn more and how to address.

Problem

When you add a SAML app to G Suite using the built-in services, the icon shown is generic and not related to the service:

 
This also impacts the app launcher, which oddly uses a different generic icon:

How can you set/change the icon?

Solution

It turns out, the only way to upload an icon to a SAML app is by adding a custom app instead of a built-in service. To do this, select the Add button under SAML apps and then select the SETUP MY OWN CUSTOM APP link at the bottom of the pop-up:

If you use this option then on step 3 you have the ability to upload your own icon:

Note: this icon must be PNG or GIF and should be 256×256 in size.

One of the benefits of using the built-in services is that they come with default entries for things such as the:

  • ACS URL
  • Entity ID
  • Start URL

In addition, they will have require attribute mappings. To address this with a custom app you either:

  1. Need to know what you are doing
  2. Find a webpage with what is required
  3. Go through the built-in workflow and manually copy what is required to your custom app

Note: the name of the SAML app must be unique so if you go with option three above but save it then you should use a temporary name.

One final thing to be aware of is that you can only set the icon during creation of the custom SAML app. You cannot change it after the fact. While it is unlikely you will have a need to change a custom SAML apps icon, I did run into issues where the icon I uploaded was not 256×256 and so it did not display right. If you do need to change the icon then you only option is to create a new custom SAML app and again manually copy over all the fields. Also be aware that every newly created custom SAML app is off by default, you will need to enable it so others can see it.

Tip: You can edit an existing SAML app and copy the necessary fields over to a new custom SAML app in a separate tab. Once done copying the necessary information do not hit save (as you will get an error about a duplicate name). Instead, delete the old custom SAML app and then save the new custom SAML app. This avoids the name conflict issue.

Assuming you follow this directions then your app launcher can feature a customized icon like these:

I ended up wasting time on this issue, but was happy to find a workaround. You would be amazed how difficult it is to use the app launcher we you have more than a handful of generic icons.

© 2018, Steve Flanders. All rights reserved.

Published inSystem Administration

Be First to Comment

    Leave a Reply

    Your email address will not be published. Required fields are marked *