Skip to content

Commit 9267fb4

Browse files
update to reflect source ID > secret ID change (#4182)
Segment used to connect to Amazon Kinesis Firehose via `sourceId`. Recently, an update was made for security reasons to use a Secret ID that is automatically created in the Settings for each Amazon Kinesis Firehose destination in Segment instead. Our documentation doesn't reflect this which leads to confusion for customers. This change updates our documentation to reflect the new way Segment connects to Firehose through Secret ID.
1 parent f0f0781 commit 9267fb4

File tree

1 file changed

+7
-7
lines changed
  • src/connections/destinations/catalog/amazon-kinesis-firehose

1 file changed

+7
-7
lines changed

src/connections/destinations/catalog/amazon-kinesis-firehose/index.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,8 @@ To get started:
3939
1. Follow [these instructions](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html#roles-creatingrole-user-console) to create an IAM role to allow Segment permission to write to your Kinesis Firehose Stream.
4040
2. When prompted to enter an Account ID, enter `595280932656`.
4141
3. Select the checkbox to enable **Require External ID**.
42-
4. Enter your Segment Source ID as the **External ID**. This can be found in Segment by navigating to **Connections > Sources** and choosing the source you want to connect to your Kinesis Firehose destination. Click the **Settings** tab and choose **API Keys**.
43-
- **Note:** If you have multiple sources using Kinesis, enter one of their source IDs here for now and then follow the procedure outlined in the [Multiple Sources](#best-practices) section at the bottom of this doc once you've completed this step and saved your IAM role.
42+
4. Enter your Secret ID as the **External ID**. This can be found in Segment by navigating to your Amazon Kinesis Firehose destination in Segment, going to the Settings tab, and clicking the Secret ID setting.
43+
- **Note:** If you have multiple sources using Kinesis, enter one of their Secret IDs here for now and then follow the procedure outlined in the [Multiple Sources](#best-practices) section at the bottom of this doc once you've completed this step and saved your IAM role.
4444
5. When adding permissions to your new role, find the policy you created in step 2 and attach it.
4545

4646
4. Create a new Kinesis Firehose Destination.
@@ -149,15 +149,15 @@ To attach multiple sources to your IAM role:
149149
"Action": "sts:AssumeRole",
150150
"Condition": {
151151
"StringEquals": {
152-
"sts:ExternalId": "YOUR_SEGMENT_SOURCE_ID"
152+
"sts:ExternalId": "YOUR_SECRET_ID"
153153
}
154154
}
155155
}
156156
]
157157
}
158158
```
159159

160-
4. Replace that snippet with the following, and replace the contents of the array with all of your source IDs.
160+
4. Replace that snippet with the following, and replace the contents of the array with all of your Secret IDs.
161161

162162
```json
163163
{
@@ -171,7 +171,7 @@ To attach multiple sources to your IAM role:
171171
"Action": "sts:AssumeRole",
172172
"Condition": {
173173
"StringEquals": {
174-
"sts:ExternalId": ["YOUR_SEGMENT_SOURCE_ID", "ANOTHER_SOURCE_ID", "A_THIRD_SOURCE_ID"]
174+
"sts:ExternalId": ["YOUR_SECRET_ID", "ANOTHER_SECRET_ID", "A_THIRD_SECRET_ID"]
175175
}
176176
}
177177
}
@@ -203,14 +203,14 @@ To set this value for a Secret ID:
203203
"Action": "sts:AssumeRole",
204204
"Condition": {
205205
"StringEquals": {
206-
"sts:ExternalId": "YOUR_SEGMENT_SOURCE_ID"
206+
"sts:ExternalId": "YOUR_SECRET_ID"
207207
}
208208
}
209209
}
210210
]
211211
}
212212
```
213-
6. Replace the value of `sts:ExternalId` ( "YOUR_SEGMENT_SOURCE_ID") with the Secret ID value from the previous step. In the case of requiring the use of multiple secretIds, replace the `sts:ExternalId` setting above with:
213+
6. Replace the value of `sts:ExternalId` ( "YOUR_SECRET_ID") with the Secret ID value from the previous step. In the case of requiring the use of multiple secretIds, replace the `sts:ExternalId` setting above with:
214214

215215
```
216216
"sts:ExternalId": ["A_SECRET_ID", "ANOTHER_SECRET_ID"]

0 commit comments

Comments
 (0)