Skip to content

Commit b41af0e

Browse files
committed
destination header fix, add new info
1 parent cab4a83 commit b41af0e

File tree

2 files changed

+15
-12
lines changed

2 files changed

+15
-12
lines changed

src/connections/destinations/add-destination.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,17 @@
22
title: Sending Segment Data to Destinations
33
---
44

5-
You've decided how to format your data, and collected it using [Segment Sources](/docs/connections/sources/). Now what do you do with it? You send the data to Destinations!
5+
You've decided how to format your data, and collected it using [Segment Sources](/docs/connections/sources/). Now what do you do with it? You send the data to Destinations.
66

77
Destinations are tools or services which can use the data sent from Segment to power analytics, marketing, customer outreach, and more.
88

99
> info ""
10-
> Each Segment Workspace has its own set of destinations, which are connected to the workspace's sources. When you add or modify a destination, make sure you're working with the correct workspace!
10+
> Each Segment Workspace has its own set of destinations, which are connected to the workspace's sources. When you add or modify a destination, make sure you're working with the correct workspace.
1111
12+
> info "HLS customers can encrypt data flowing into their destinations"
13+
> If you are a HLS customer with a HIPAA Eligible workspace, you can enable data encryption to encrypt data before it flows into your destination.
14+
>
15+
> To learn more about data encryption, see the [HIPAA Eligible Segment](/docs/privacy/hipaa-eligible-segment/#data-encryption) documentation.
1216
1317
## Adding a destination
1418

@@ -58,21 +62,21 @@ You can use the Segment Public API to add destinations to your workspace using t
5862

5963
Adding a destination can have a few different effects, depending on which sources you set up to collect your data, and how you configured them.
6064

61-
#### Analytics.js
65+
### Analytics.js
6266

6367
If you are using [Segment's JavaScript library, Analytics.js](/docs/connections/sources/catalog/libraries/website/javascript/), then Segment handles any configuration changes you need for you. If you're using Analytics.js in cloud-mode, the library sends its tracking data to the Segment servers, which route it to your destinations. When you change which destinations you send data to, the Segment servers automatically add that destination to the distribution list.
6468

6569
If you're using Analytics.js in device-mode, then Analytics.js serves as a wrapper around additional code used by the individual destinations to run on the user's device. When you add a destination, the Segment servers update a list of destinations that the library queries. When a user next loads your site, Analytics.js checks the list of destinations to load code for, and adds the new destination's code to what it loads. It can take up to 30 minutes for the list to update, due to CDN caching.
6670

6771
You can enable device-mode for some destinations from the destination's Settings page in the Segment web app. You don't need to use the same mode for all destinations in a workspace; some can use device-mode, and some can use cloud-mode.
6872

69-
#### Mobile sources
73+
### Mobile sources
7074

7175
By default, Segment's [mobile sources](/docs/connections/sources/catalog/#mobile) send data to Segment in cloud-mode to help minimize the size of your apps. In cloud-mode the mobile source libraries forward the tracking data to the Segment servers, which route the data to the destinations. Since the Segment servers know which destinations you're using, you don't need to take any action to add destinations to mobile apps using cloud-mode.
7276

7377
However, if the destination you're adding has features that run on the user's device, you might need to update the app to package that destination's SDK with the library. Some destinations require that you package the SDK, and some only offer it
7478

75-
#### Server sources
79+
### Server sources
7680

7781
Segment's [server sources](/docs/connections/sources/catalog/#server) run on your internal app code, and never have access to the user's device. They run in cloud-mode only, and forward their tracking calls to the Segment servers, which forward the data to any destinations you enabled.
7882

src/privacy/hipaa-eligible-segment.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -35,12 +35,12 @@ These logs can be provided upon request. For specific requests, please reach out
3535

3636
## Data encryption
3737

38-
Segment can encrypt PHI/PII before sending it to event stream, cloud mode destinations, further supporting HIPAA compliance in your destinations.
39-
40-
Segment encrypts the data in fields [marked as yellow in the Privacy Portal](/docs/privacy/portal/#default-pii-matchers) with a public/private key pair. After Segment encrypts the data, it is converted into a `string`. Any downstream validation that looks for `integer` data types will fail for encrypted values.
38+
Segment encrypts the data in fields [marked as yellow in the Privacy Portal](/docs/privacy/portal/#default-pii-matchers) before sending it to event stream, cloud mode destinations, further supporting HIPAA compliance in your destinations.
4139

4240
> info "Data encryption is currently in public beta"
43-
> Data encryption supports event-stream, cloud-mode destinations. Engage destinations are not supported. Only data fields in `context`, `traits`, and `property` objects can be encrypted. =
41+
> Data encryption supports event-stream, cloud-mode destinations. Engage destinations are not supported. Only data fields in `context`, `traits`, and `property` objects can be encrypted.
42+
>
43+
> After Segment encrypts the data, it is converted into a `string`. Any downstream validation that looks for `integer` data types will fail for encrypted values.
4444
4545
### Configure data encryption for a new destination
4646

@@ -55,7 +55,7 @@ To configure data encryption while setting up a new destination:
5555
8. Click **Create destination**.
5656

5757
> error "Private Key is not recoverable"
58-
> Segment does not save the private key created during the data encryption setup flow, and cannot retrieve the key after you finish setting up your destination. You can generate a new key without decrypting your data using the instructions in the [Configure new key pairs](#configure-new-key-pairs) section.
58+
> Segment does not save the private key created during the data encryption setup flow, and cannot retrieve the key after you finish setting up your destination. You can generate a new key without decrypting your data using the instructions in the [Configure new key pairs](#configure-new-key-pairs) section. Any data encrypted prior to generating a new key pair cannot be decrypted with the new key.
5959
6060
### Configure data encryption for an existing destination
6161

@@ -68,8 +68,7 @@ To configure data encryption for an existing destination:
6868
6. Click **Save**.
6969

7070
> error "Private Key is not recoverable"
71-
> Segment does not save the private key created during the data encryption setup, and cannot retrieve the key after you add data encryption to your destination. Segment cannot decrypt data if this key is lost. You can generate a new key any time using the instructions in the [Configure new key pairs](#configure-new-key-pairs) section. All updates are forward looking
72-
71+
> Segment does not save the private key created during the data encryption setup, and cannot retrieve the key after you add data encryption to your destination. Segment cannot decrypt data if this key is lost. You can generate a new key any time using the instructions in the [Configure new key pairs](#configure-new-key-pairs) section. Any data encrypted prior to generating a new key pair cannot be decrypted with the new key.
7372
7473
### Configure new key pairs
7574

0 commit comments

Comments
 (0)