Responding to a behavior graph invitation - Amazon Detective

Responding to a behavior graph invitation

When you accept an invitation, your account status is set initially to Not enabled while Detective checks whether your account would cause the data volume for the behavior graph to exceed the Detective quota. For Detective to make this check, your account must have Amazon GuardDuty enabled for at least 48 hours.

If your account would not cause the behavior graph to exceed the quota, Detective updates your account status to Enabled. Detective begins to ingest and extract data from logs and findings into the behavior graph as of that point in time. Your account is charged for the data.

If the addition of your account would cause the volume of data for the behavior graph to exceed the Detective quota, or if you do not have GuardDuty enabled, the status remains Not enabled. In this case, unless you remove your account, Detective automatically enables your account as soon as the behavior graph can accommodate it. The administrator account can also enable your account manually.

If you decline the invitation, then it is removed from your list of invitations, and Detective does not use your account data in the behavior graph.

Responding to a behavior graph invitation (console)

You can use the AWS Management Console to respond to the email invitation, which includes a link to the Detective console. You can only respond to an invitation that has a status of Invited.

To respond to a behavior graph invitation (console)
  1. Open the Amazon Detective console at https://console.aws.amazon.com/detective/.

  2. In the Detective navigation pane, choose Account management.

  3. Under My administrator accounts, to accept the invitation and begin contributing data to the behavior graph, choose Accept invitation.

    To decline the invitation and remove it from the list, choose Decline.

Responding to a behavior graph invitation (Detective API, AWS CLI)

You can respond to behavior graph invitations from the Detective API or the AWS Command Line Interface.

To accept a behavior graph invitation (Detective API, AWS CLI)
  • Detective API: Use the AcceptInvitation operation. You must specify the graph ARN.

  • AWS CLI: At the command line, run the accept-invitation command.

    aws detective accept-invitation --graph-arn <behavior graph ARN>

    Example:

    aws detective accept-invitation --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234
To decline a behavior graph invitation (Detective API, AWS CLI)
  • Detective API: Use the RejectInvitation operation. You must specify the graph ARN.

  • AWS CLI: At the command line, run the reject-invitation command.

    aws detective reject-invitation --graph-arn <behavior graph ARN>

    Example:

    aws detective reject-invitation --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234