Step 1: Create a portal in SiteWise Monitor - Amazon IoT SiteWise
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Step 1: Create a portal in SiteWise Monitor

In this procedure, you create a portal in Amazon IoT SiteWise Monitor. Each portal is a managed web application that you and your users can sign in to with Amazon IAM Identity Center accounts. With IAM Identity Center, you can use your company's existing identity store or create one managed by Amazon. Your company's employees can sign in without creating separate Amazon Web Services accounts.

To create a portal
  1. Sign in to the Amazon IoT SiteWise console.

  2. Review the Amazon IoT SiteWise endpoints and quotas where Amazon IoT SiteWise is supported and switch Regions, if needed. You must run the Amazon IoT SiteWise demo in the same Region.

  3. In the left navigation pane, choose Portals.

  4. Choose Create portal.

  5. If you already enabled IAM Identity Center, skip to step 6. Otherwise, complete the following steps to enable IAM Identity Center:

    1. On the Enable Amazon IAM Identity Center (SSO) page, enter your Email address, First name, and Last name to create an IAM Identity Center user for yourself to be the portal administrator. Use an email address you can access so that you can receive an email to set a password for your new IAM Identity Center user.

      In a portal, the portal administrator creates projects and assigns users to projects. You can create more users later.

      The "Enable Amazon IAM Identity Center (SSO)" page of the "Create portal" process.
    2. Choose Create user.

  6. On the Portal configuration page, complete the following steps:

    1. Enter a name for your portal, such as WindFarmPortal.

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

    3. (Optional) Upload an image to display in the portal.

    4. Enter an email address that portal users can contact when they have an issue with the portal and need help from your company's Amazon administrator to resolve it.

    5. Choose Create portal.

  7. On the Invite administrators page, you can assign IAM Identity Center users to the portal as administrators. Portal administrators manage permissions and projects within a portal. On this page, do the following:

    1. Select a user to be the portal administrator. If you enabled IAM Identity Center earlier in this tutorial, select the user that you created.

      The "Invite administrators" page of the "Create portal" process.
    2. (Optional) Choose Send invite to selected users. Your email client opens, and an invitation appears in the message body. You can customize the email before you send it to your portal administrators. You can also send the email to your portal administrators later. If you're trying SiteWise Monitor for the first time and will be the portal administrator, you don't need to email yourself.

    3. Choose Next.

  8. On the Assign users page, you can assign IAM Identity Center users to the portal. Portal administrators can later assign these users as project owners or viewers. Project owners can create dashboards in projects. Project viewers have read-only access to the projects that they're assigned. On this page, you can create IAM Identity Center users to add to the portal.

    Note

    If you aren't signed in to your Amazon Organizations management account, you can't create IAM Identity Center users. Choose Assign users to create the portal without portal users, and then skip this step.

    On this page, do the following:

    1. Complete the following steps twice to create two IAM Identity Center users:

      1. Choose Create user to open a dialog box where you enter details for the new user.

      2. Enter an Email address, First name, and Last name for the new user. IAM Identity Center sends the user an email for them to set their password. If you want to sign in to the portal as these users, choose an email address that you can access. Each email address must be unique. Your users sign in to the portal using their email address as their usernames.

        The "Portal details" page with "Assign users" highlighted.
      3. Choose Create user.

    2. Select the two IAM Identity Center users that you created in the previous step.

      The "Assign users" page with the new IAM Identity Center users highlighted.
    3. Choose Assign users to add these users to the portal.

    The portals page opens with your new portal listed.