Coordinate Rollout

When the white-labeled domain is ready to go live, coordinate its rollout to the user community. This coordination is important because after the white-labeled domain is exposed, users can no longer access workspaces and dashboards through https://secure.gooddata.com.* *In the GoodData Customer Support request for white-labeling, you must agree with Support on a rollout date.

Before rollout

1. Communicate the timeline of the rollout to all impacted users and your GoodData domain administrator.

2. Verify that users of the white-labeled environment understand that they workspaces and dashboards will be available only through the new URL, not through https://secure.gooddata.com.

3. Notify developers maintaining the white-labeled domain that they must use the new domain for GoodData API calls.

   To perform calls using https://secure.gooddata.com after migrating to the white-labeled domain, you must include the following HTTP header:

   X-GDC-CHECK-DOMAIN=false
   

   If you forget this header, you receive an error message like the following:

   javax.net.ssl.SSLException: hostname in certificate didn't match: !=
   

After rollout

Ask users to log in to the new domain and verify their access. If users cannot access the white-labeled domain, ask the administrator to add them via API or open a  GoodData Customer Support request.

After users have been added to the domain, use the Invite User API to add users to specific workspaces. Users receive an email invitation, which may or may not have been customized yet. When accepted, they have immediate access to the workspace.

To silently add users to the workspace without sending an invitation, use the Add User API.