Creating an AppInstanceUser
Once you create an AppInstance
, you create an AppInstanceUser
in that AppInstance
. You typically do this when a user first registers or logs in to your app.
You can also create an AppInstanceUser
that acts on behalf of your back-end services.
The following example shows how to create a back-end AppInstanceUser
:
aws chime-sdk-identity create-app-instance-user \ --app-instance-arn "
app_instance_arn
" \ --app-instance-user-id "back-end-worker" \ --name "back-end-worker"
In the create response, note the AppInstanceUserArn
. It takes this form: arn:aws:chime:
. In this example, region
:aws_account_id
:app-instance/app_instance_id
/user/app_instance_user_id
app_instance_user_id
is "back-end-worker."
Note
As a best practice, when creating an AppInstanceUser
for a client application, have the AppInstanceId
match an existing unique ID for that user, such as the sub
of an identity provider.
The name is an optional placeholder that is attached to some API entities, such as a message sender. It allows you to control the display name of a user in one place, rather then needing to look it up from AppInstanceUser
ARN,
which is also attached as the sender of a message.