Configure your portal in SiteWise Monitor - AWS IoT SiteWise

Configure your portal in SiteWise Monitor

Your users use portals to view your data. You can customize a portal's name, description, branding, user authentication, support contact email, and permissions.

The "Portal configuration" page used to create a portal.
To configure a portal
  1. Enter a name for your portal.

  2. (Optional) Enter a description for your portal. If you have multiple portals, use meaningful descriptions to help you keep track of what each portal contains.

  3. (Optional) Upload an image to display your brand in the portal. Choose a square, PNG image. If you upload a non-square image, the portal scales the image down to a square.

  4. Choose one of the following options:

    • Choose IAM Identity Center if your portal users sign in to this portal with their corporate user names and passwords.

      If you haven't enabled IAM Identity Center in your account, do the following:

      1. Choose Create user.

      2. On the Create user page, to create the first portal, enter the user's email address, first name, and last name, and then choose Create user.

        Enable IAM Identity Center if you haven't enable IAM Identity Center in your AWS account.
        Note
        • AWS automatically enables IAM Identity Center in your account when you create the first portal user.

        • You can configure IAM Identity Center in only one Region at a time. SiteWise Monitor connects to the Region that you configured for IAM Identity Center. This means that you use one Region for IAM Identity Center access, but you can create portals in any Region.

      • Choose IAM if your portal users sign in to this portal with their IAM credentials.

        Important

        Users or roles must have the iotsitewise:DescribePortal permission to sign in to the portal.

  5. Enter an email address that portal users can contact when they have an issue with the portal and need help to resolve it.

  6. (Optional) Add tags for your portal. For more information, see Tag your AWS IoT SiteWise resources.

  7. Choose one of the following options:

    • Choose Create and use a new service role. By default, SiteWise Monitor automatically creates a service role for each portal. This role allows your portal users to access your AWS IoT SiteWise resources. For more information, see Use service roles for AWS IoT SiteWise Monitor.

    • Choose Use an existing service role, and then choose the target role.

  8. Choose Next

  9. (Optional) Enable alarms for your portal. For more information, see Turn on alarms for your portals in AWS IoT SiteWise.

  10. Choose Create. AWS IoT SiteWise will create your portal.

    Note

    If you close the console, you can finish the setup process by adding administrators and users. For more information, see Add or remove portal administrators in AWS IoT SiteWise. If you don't want to keep this portal, delete it so it doesn't use resources. For more information, see Delete a portal in AWS IoT SiteWise.

The Status column can be one of the following values.

  • CREATING - AWS IoT SiteWise is processing your request to create the portal. This process can take several minutes to complete.

  • UPDATING - AWS IoT SiteWise is processing your request to update the portal. This process can take several minutes to complete.

  • PENDING - AWS IoT SiteWise is waiting for the DNS record propagation to finish. This process can take several minutes to complete. You can delete the portal while the status is PENDING.

  • DELETING - AWS IoT SiteWise is processing your request to delete the portal. This process can take several minutes to complete.

  • ACTIVE - When the portal becomes active, your portal users can access it.

  • FAILED - AWS IoT SiteWise couldn't process your request to create, update, or delete the portal. If you enabled AWS IoT SiteWise to send logs to Amazon CloudWatch Logs, you can use these logs to troubleshoot issues. For more information, see Monitoring AWS IoT SiteWise with CloudWatch Logs.

A message appears when your portal is created.

An example successful portal creation message.

Next, you must invite one or more portal administrators to the portal. So far, you created a portal but no one can access it.