Private attributes

In the client-side .NET SDK there are two ways to define private attributes for the entire LaunchDarkly client:

• When creating the LaunchDarkly Configuration object, you can call the AllAttributesPrivate method, which takes in a boolean parameter. If true, all context attributes except the kind and key are removed for all contexts before the SDK sends the context to LaunchDarkly.
• When creating the LaunchDarkly Configuration object, you can call the PrivateAttributes method, which takes any number of attribute names or slash-delimited paths to designated JSON properties within an attribute, such as /address/street. If any context has a custom or built-in attribute that matches one of these names, the SDK removes it before sending the context to LaunchDarkly.

For example:

1
// All attributes marked private
2
var configAllPrivate = Configuration
3
  .Builder("mobile-key-123abc", ConfigurationBuilder.AutoEnvAttributes.Enabled)
4
  .AllAttributesPrivate(true)
5
  .Build();
6
LdClient client = LdClient.Init(configAllPrivate, context);
7
8
// Two attributes marked private
9
var configSomePrivate = Configuration.Builder("mobile-key-123abc")
10
  .PrivateAttributes("email", "address")
11
  .Build();
12
LdClient client = LdClient.Init(configSomePrivate, context);

You can also mark attributes as private when building the context object by calling Private() on the context builder.

For example:

1
var context = Context.Builder("context-key-123abc")
2
    .Set("email", "sandy@example.com")
3
    .Private("email")
4
    .Build();

When the SDK sends this context back to LaunchDarkly, it removes the email attribute.

In the Android SDK you can define private attributes for the entire LaunchDarkly client. When creating the LDConfig object, call the privateAttributes method, which takes in a set of custom or built-in attributes as a parameter. If any context has a custom or built-in attribute named in this set, the SDK removes it before sending the context to LaunchDarkly.

Here’s how to configure private attributes:

1
// All attributes marked private
2
LDConfig ldConfig = new LDConfig.Builder(AutoEnvAttributes.Enabled)
3
    .mobileKey("mobile-key-123abc")
4
    .events(
5
      Components.sendEvents()
6
          .allAttributesPrivate(true)
7
    )
8
    .build();
9
10
// Two attributes marked private
11
LDConfig ldConfig = new LDConfig.Builder(AutoEnvAttributes.Enabled)
12
    .mobileKey("mobile-key-123abc")
13
    .events(
14
        Components.sendEvents()
15
            .privateAttributes("name", "group")
16
    )
17
    .build();

You can also mark attributes as private when building the context object by using the private versions of the builder methods to set the attributes. For example:

1
LDContext context = LDContext.builder("context-key-123abc")
2
    .set("email", "sandy@example.com")
3
    .set("name", "Sandy")
4
    .set("group", "Microsoft")
5
    .privateAttributes("name", "group")

When the SDK sends this context back to LaunchDarkly, it removes the name and group attributes.

In the C++ SDK there are two ways to define private attributes for the LaunchDarkly client:

• When using the ConfigBuilder, you can call AllAttributesPrivate(). When you do this, all context attributes except the kind and key are removed before the SDK sends the context to LaunchDarkly.
• When using the ConfigBuilder, you can configure a set of PrivateAttributes(). If any context has an attribute named in this list, the SDK removes it before sending the context to LaunchDarkly.

Here’s how:

1
/* sets all attributes private */
2
auto config_builder = client_side::ConfigBuilder("mobile-key-123abc");
3
config_builder.Events().AllAttributesPrivate(true);
4
auto config_all_private = config_builder.Build();
5
6
/* sets "email" and "address" private */
7
auto config_builder = client_side::ConfigBuilder("mobile-key-123abc");
8
config_builder.Events().PrivateAttributes({"email", "address"});
9
auto configSomePrivate = config_builder.Build();

You can also define private attributes for a particular context by calling .SetPrivate() in the ContextBuilder.

Here’s how:

1
auto context = ContextBuilder()
2
  .Kind("user", "user-key-123abc")
3
  .Name("Sandy Smith")
4
  .SetPrivate("email", "sandy@example.com")
5
  .Build();

To learn more, read ContextBuilder.

To mark all user attributes except the key as private, use the allAttributesPrivate option:

1
const user = {
2
  key: 'user-key-123abc',
3
  name: 'Sandy Smith',
4
  email: 'sandy@example.com'
5
};
6
7
const client = LDElectron.initialize('client-side-id-123abc', user, {
8
  allAttributesPrivate: true
9
});

In the above example, the SDK removes the name and email attributes.

You can also specify an array of which attributes should be private with the privateAttributeNames option. You can configure this option on a per-user basis by specifying which attributes should be private in your user object.

This option is configured in both the user object and the configuration object:

1
const user = {
2
  key: 'user-key-123abc',
3
  name: 'Sandy Smith',
4
  email: 'sandy@example.com',
5
  privateAttributeNames: ['email']
6
};
7
8
const client = LDElectron.initialize('client-side-id-123abc', user, {
9
  privateAttributeNames: ['email']
10
});

In the above example, the SDK sends only the key and name back to LaunchDarkly.

In the Flutter SDK, you can define private attributes for the entire LaunchDarkly client. When you create the LDConfig object, you can set all attributes private for all contexts. You can also provide a list of attributes to the globalPrivateAttributes option. If any context has an attribute named in this set, the SDK removes it before sending the context to LaunchDarkly.

1
final config = LDConfig(
2
  CredentialSource.fromEnvironment,
3
  AutoEnvAttributes.enabled,
4
  allAttributesPrivate: true, // all attributes marked private
5
  globalPrivateAttributes: ['user/email', 'user/group'], // two attributes marked private for the 'user' context kind
6
)

You can also mark attributes as private when building the context object by using the private optional parameter. For example:

1
final context = LDContextBuilder()
2
  .kind('user', 'user-key-123abc'),
3
  .setString('name', 'Sandy')
4
  .setString('email', 'sandy@example.com', private: true)
5
  .setString('group', 'microsoft', private: true)
6
  .build();

When the SDK sends this context back to LaunchDarkly, the email and group attributes are removed.

To learn more about the configuration options for private attributes, read allAttributesPrivate and globalPrivateAttributes. To learn more about setting private attributes for a specific context, read LDContext.

In the iOS SDK there are two ways to define private attributes for the entire LaunchDarkly client:

• When creating the LDConfig object, you can set the allContextAttributesPrivate attribute to true.
• When creating the LDConfig object, you can set the privateContextAttributes property to a list of References, such as [Reference("name"), Reference("/address/state")]. If any context has a custom or built-in attribute named in this list, the SDK removes it before sending the context to LaunchDarkly.

For example:

1
// All attributes marked private
2
config = LDConfig(mobileKey: "mobile-key-123abc", autoEnvAttributes: .enabled)
3
config.allContextAttributesPrivate = true
4
5
// Two attributes marked private
6
config = LDConfig(mobileKey: "mobile-key-123abc", autoEnvAttributes: .enabled)
7
config.privateContextAttributes = [Reference("email"), Reference("address")]

You can also mark attributes as private on a particular LDContext instance, for example:

1
var contextBuilder = LDContextBuilder(key: "context-key-123abc")
2
contextBuilder.trySetValue("name", .string("Sandy"))
3
contextBuilder.trySetValue("group", .array([LDValue(stringLiteral: "microsoft")]))
4
contextBuilder.addPrivateAttribute(Reference("name"))
5
contextBuilder.addPrivateAttribute(Reference("group"))
6
7
let context = try contextBuilder.build().get()

You can configure the private attributes option either in the configuration object or in the context object.

In the configuration object, to mark all attributes except the key as private in the JavaScript SDK, use the allAttributesPrivate option. To mark some attributes as private specify your array of attributes in the privateAttributes configuration option.

Here’s how:

1
const context = {
2
  kind: 'user',
3
  key: 'user-key-123abc',
4
  name: 'Sandy Smith',
5
  email: 'sandy@example.com'
6
};
7
8
// All attributes marked private
9
const ldclient = ld.initialize('client-side-id-123abc', context, options = {
10
  allAttributesPrivate: true
11
});
12
// Two attributes marked private
13
const ldclient = ld.initialize('client-side-id-123abc', context, options = {
14
  privateAttributes: ['email', 'name']
15
});

In the context object, specify your array of attributes in the privateNames field of the reserved _meta property.

Here’s how:

1
const context = {
2
  kind: 'user',
3
  key: 'context-key-123abc',
4
  name: 'Sandy Smith',
5
  email: 'sandy@example.com',
6
  _meta: {
7
    privateAttributes: ['email']
8
  }
9
};
10
11
const ldclient = ld.initialize('client-side-id-123abc', context, options = {
12
  privateAttributes: ['email']
13
});

In the above example, the SDK sends only the context’s key and name back to LaunchDarkly.

To mark all user attributes except the key as private in the Node.js SDK, you can use the allAttributesPrivate option:

1
const context = {
2
  kind: 'user',
3
  key: 'user-key-123abc',
4
  name: 'Sandy Smith',
5
  email: 'sandy@example.com'
6
};
7
// All attributes marked private
8
const client = ld.initialize('client-side-id-123abc', context, {
9
  allAttributesPrivate: true
10
});
11
// Two attributes marked private
12
const client = ld.initialize('client-side-id-123abc', context, {
13
  privateAttributes: ['email', 'name']
14
});

You can also specify an array of which attributes should be private with the privateAttributes option. You can configure this option on a per-context basis by specifying which attributes should be private in your context object.

You can configure this option in both the context object and the configuration object:

1
const context = {
2
  kind: 'user',
3
  key: 'user-key-123abc',
4
  name: 'Sandy Smith',
5
  email: 'sandy@example.com'
6
  _meta: {
7
    privateAttributes: ['email']
8
  }
9
};
10
11
const client = ld.initialize('client-side-id-123abc', context, {
12
  privateAttributes: ['email']
13
});

In the above example, the SDK sends only the context key and name back to LaunchDarkly.

You can configure this option in the configuration object, to apply to all contexts, either for all attributes or some attributes:

1
// All attributes marked private
2
const options = {
3
  allAttributesPrivate: true
4
}
5
const client = new ReactNativeLDClient('mobile-key-123abc', AutoEnvAttributes.Enabled, options);
6
7
// Two attributes marked private
8
const options = {
9
  privateAttributes: ['email', 'address']
10
}
11
const client = new ReactNativeLDClient('mobile-key-123abc', AutoEnvAttributes.Enabled, options);

To learn more, read allAttributesPrivate and privateAttributes.

You can also mark an attribute as private for a particular context:

1
const context = {
2
  kind: 'user',
3
  key: 'user-key-123abc',
4
  firstName: 'Sandy',
5
  lastName: 'Smith',
6
  email: 'sandy@example.com',
7
  address: {
8
    street: '123 Main St',
9
    city: 'Springfield'
10
  },
11
  _meta: {
12
    privateAttributes: ['email', '/address/street']
13
  }
14
};

For attributes that are objects, you can mark specific fields private, using the / delimiter followed by the attribute name, then the / delimiter followed by the JSON property within the value. In the example, the attribute "address": { "street": "Main St", "city": "Springfield" } has only the /address/street marked as private.

You can configure this option in the configuration object, to apply to all contexts, either for all attributes or some attributes:

1
' All attributes marked private
2
config = LaunchDarklyConfig("mobile-key-123abc", launchDarklyTaskNode)
3
config.setAllAttributesPrivate(true)
4
5
LaunchDarklySGInit(config, context)
6
client = LaunchDarklySG(launchDarklyTaskNode)
7
8
' Two attributes marked private
9
config = LaunchDarklyConfig("mobile-key-123abc", launchDarklyTaskNode)
10
config.addPrivateAttribute("email")
11
config.addPrivateAttribute("address")
12
13
LaunchDarklySGInit(config, context)
14
client = LaunchDarklySG(launchDarklyTaskNode)

You can also mark an attribute as private for a particular context:

1
' when creating a context
2
context = LaunchDarklyCreateContext({
3
    "kind": "user",
4
    "key": "context-key-123-abc",
5
    "email": "sandy@example.com",
6
    "_meta": { privateAttributes: ["email"] }
7
})
8
9
' for an existing context
10
context.addPrivateAttribute("email")
11
context.addPrivateAttribute("/address/street")

In the server-side .NET SDK there are two ways to define private attributes for the entire LaunchDarkly client:

• When creating the LaunchDarkly Configuration object, you can configure Events with AllAttributesPrivate, which takes in a boolean parameter. If true, the SDK removes all attributes for all contexts before sending the context to LaunchDarkly, except the key.
• Or, you can configure Events with PrivateAttributes, which takes any number of attribute names or slash-delimited paths to designated a JSON property within an attribute, such as /address/street. If any context has a custom or built-in attribute that matches one of these names, the SDK removes it before sending the context to LaunchDarkly.

For example:

1
// All attributes marked as private
2
var config = Configuration.Builder("sdk-key-123abc")
3
    .Events(
4
        Components.SendEvents()
5
           .AllAttributesPrivate(true)  // defaults to false
6
    )
7
    .Build();
8
9
var client = new LDClient(config);
10
11
// Two attributes marked as private
12
var config = Configuration.Builder("sdk-key-123abc")
13
    .Events(
14
        Components.SendEvents()
15
          .PrivateAttributes("email", "address")
16
    )
17
    .Build();
18
19
var client = new LDClient(config);

You can also mark attributes as private when building the context object by calling Private() after setting the attribute on the context builder.

For example:

1
var context = Context.Builder("context-key-123abc")
2
    .Set("email", "sandy@example.com")
3
    .Private("email")
4
    .Build();

When the SDK sends this context back to LaunchDarkly, it removes the email attribute.

You can configure the Apex SDK to treat some or all user attributes as private user attributes, either using the LDConfig object or on a per-user basis.

When creating the LDConfig object, you can use setAllAttributesPrivate(true). When you do this, all user attributes, except the key, are redacted before the SDK sends the user to LaunchDarkly.

Here’s how:

1
LDConfig config = new LDConfig.Builder()
2
    .setAllAttributesPrivate(true)
3
    .build();

You can also define private attribute names on a per-user basis:

1
Set<String> privateAttributes = new Set<String>();
2
privateAttributes.add('firstName');
3
4
LDUser user = new LDUser.Builder('user-key-123abc')
5
    .setFirstName('alice')
6
    .setPrivateAttributeNames(privateAttributes)
7
    .build();

In the C++ SDK there are three ways to define private attributes for the LaunchDarkly client:

• When creating the config object, you can use AllAttributesPrivate. When you do this, the SDK only sends the context key and kind to LaunchDarkly.

  For example:

  C++ SDK v3.0 (native)C++ SDK v3.0 (C binding)C SDK v2.x (native)

  1
  auto config_builder = server_side::ConfigBuilder("sdk-key-123abc");
  2
  config_builder.Events().AllAttributesPrivate(true);
  3
  auto config = config_builder.Build();

• When creating the config object, you can list specific private attributes with PrivateAttributes. The SDK removes all attributes in this list before sending the context to LaunchDarkly.

  Here’s how:

  C++ SDK v3.0 (native)C SDK v2.x (native)

  1
  auto config_builder = server_side::ConfigBuilder("sdk-key-123abc");
  2
  config_builder.Events().PrivateAttributes({"email"});
  3
  auto config = config_builder.Build();
  4
  if (!config) {
  5
      /* an error occurred, config is not valid */
  6
  }

• You can also define private attributes on a per-context basis. For example:

  C++ SDK v3.0 (native)C SDK v2.x (native)

  1
  auto context = ContextBuilder()
  2
    .Kind("user", "user-key-123abc")
  3
    .SetPrivate("email", "sandy@example.com")
  4
    .Build();

To learn more, read ContextBuilder.

Here’s how to set context attributes as private for all or just some contexts:

1
%% All attributes marked as private
2
ldclient:start_instance("sdk-key-123abc", #{private_attributes => all}).
3
4
%% Two attributes marked as private
5
ldclient:start_instance("sdk-key-123abc", #{private_attributes => [<<"email">>, <<"address">>]}).

Here’s how to set context attributes as private for a specific context:

1
    ContextWithPrivateAttributes = ldclient_context:set_private_attributes([<<"name">>, <<"/address/street">>],
2
        ldclient_context:set(<<"name">>, <<"Global Health Services">>,
3
        ldclient_context:set(<<"email">>, <<"info@globalhealthexample.com">>,
4
        ldclient_context:set(<<"address">>, #{
5
            <<"street">> => <<"123 Main Street">>,
6
            <<"city">> => <<"Springfield">>
7
        },
8
    ldclient_context:new(<<"context-key-456def">>, <<"organization">>))))),

In the example, only the name and /address/street attributes are private for this context.

In the Go SDK there are two ways to define private attributes for the entire LaunchDarkly client:

• You can set the configuration option AllAttributesPrivate to true. If you enable this, the SDK removes all attributes for all contexts before it sends the context to LaunchDarkly, except the key and kind.
• You can set the configuration option PrivateAttributes to a list of attribute names. If any context has an attribute named in this list, the SDK removes it before sending the context to LaunchDarkly.

Here’s how to to define private attributes:

1
import (
2
    ld "github.com/launchdarkly/go-server-sdk/v6"
3
    "github.com/launchdarkly/go-server-sdk/v6/ldcomponents"
4
)
5
6
var config ld.Config
7
8
// Make all attributes private for all contexts
9
config.Events = ldcomponents.SendEvents().AllAttributesPrivate(true)
10
11
// Or, make just the email and address attributes private for all contexts
12
config.Events = ldcomponents.SendEvents().
13
    PrivateAttributes("name", "email")

You can also define a set of private attributes on the context object itself. In the following example, “email” and the “street” field of the “address” attribute are private for this context, in addition to any private attributes that were specified globally:

1
import (
2
    "github.com/launchdarkly/go-sdk-common/v3/ldcontext"
3
)
4
5
context := ldcontext.NewBuilder("context-key-123abc").
6
    Kind("organization").
7
    Name("Global Health Services").
8
    SetString("email", "info@globalhealthexample.com").
9
    SetValue("address", ldvalue.ObjectBuild().
10
        SetString("street", "123 Main Street").
11
        SetString("city", "Springfield")).
12
    Private("email").
13
    Private("/address/street").
14
    Build()

Optionally, you can configure the Haskell SDK to treat some or all context attributes as private attributes. You can use private context attributes for targeting purposes, but the SDK removes private context attributes from the data it sends to LaunchDarkly.

There are two ways to define private attributes for the entire LaunchDarkly client:

• When you create the Config object, use configSetAllAttributesPrivate to set all context attributes as private. When you do this, all context attributes, except the key and kind, are removed before the SDK sends the context to LaunchDarkly.
• When you create the Config object, you can list specific private attributes with configSetPrivateAttributeNames. If any context has attributes named in this list, the SDK removes them before sending the context to LaunchDarkly.

Here’s how:

1
-- All attributes marked private
2
makeConfig "sdk-key-123abc" & configSetAllAttributesPrivate True
3
4
-- Two attributes marked private
5
import qualified Data.Set as S
6
import qualified LaunchDarkly.Server.Reference as R
7
8
makeConfig sdkKey
9
  & configSetAllAttributesPrivate True
10
  & configSetPrivateAttributeNames (S.fromList $ map R.makeLiteral ["name", "email"])
11
config = LaunchDarkly::Config.new({private_attributes: ["name", "email"]})

You can also define private attribute names on a per-context basis.

For example:

1
makeContext "key" "user"
2
  & withName "Sandy"
3
  & withAttribute "email" "sandy@example.com"
4
  & withPrivateAttributes (S.fromList $ map R.makeLiteral ["name", "email"])

In the Java SDK there are two ways to define private attributes for the entire LaunchDarkly client:

• When creating the LDConfig object, you can call the allAttributesPrivate method, which takes in a boolean parameter. If true, all context attributes except the key for all contexts are removed before the SDK sends the context to LaunchDarkly.
• When creating the LDConfig object, you can call the privateAttributes method, which takes in a set of custom or built-in attributes as a parameter. If any context has a custom or built-in attribute named in this list, the SDK removes it before sending the context to LaunchDarkly.

Here’s how to define private attributes:

1
// All attributes marked private
2
LDConfig configWithAllAttributesPrivate = new LDConfig.Builder()
3
  .events(
4
    Components.sendEvents()
5
      .allAttributesPrivate(true)
6
  )
7
  .build();
8
9
// Some attributes marked private
10
LDConfig configWithSpecificAttributesPrivate = new LDConfig.Builder()
11
  .events(
12
    Components.sendEvents()
13
      .privateAttributes("name", "email", "someAttribute")
14
  )
15
  .build();

You can also mark attributes as private when building the context object by calling the privateAttributes builder method. For example:

1
LDContext context = LDContext.builder("context-key-123abc")
2
  .set("email", "sandy@example.com")
3
  .privateAttributes("email")
4
  .build();

When the SDK sends this context back to LaunchDarkly, it removes the email attribute.

In the Lua SDK there are two ways to define private attributes for the LaunchDarkly client:

• Use allAttributesPrivate to remove all context attributes except for the kind and key from all contexts before the SDK sends the contexts to LaunchDarkly.
• Use privateAttributes to designate a list of private attributes. If any context has an attribute named in this list, the SDK removes that attribute before sending the context to LaunchDarkly.

Here’s how to mark attributes as private:

1
-- sets all attributes private
2
local configAllPrivate = {
3
    events = {
4
        allAttributesPrivate = true
5
    }
6
}
7
8
-- sets "email" and "address" private
9
local configSomePrivate = {
10
    events = {
11
        privateAttributes = { "email", "address" }
12
    }
13
}

You can also define private attributes for a particular context using a list of privateAttributes:

1
local user = ld.makeContext({
2
    user = {
3
        key  = "user-key-123abc",
4
        attributes = {
5
            firstName = "Sandy",
6
            lastName  = "Smith",
7
            email     = "sandy@example.com",
8
            groups    = { "Google", "Microsoft" }
9
        },
10
        privateAttributes = { "email "}
11
    }
12
})

To learn more, read clientInit and makeContext.

In the Node.js SDK there are two ways to define private attributes for the entire LaunchDarkly client:

• In the LaunchDarkly LDOptions, you can set allAttributesPrivate to true. If you enable this, the SDK removes all attributes for all contexts before sending the context to LaunchDarkly, except the kind and key.
• In the LaunchDarkly LDOptions object, you can define a list of privateAttributes. If any context has a custom or built-in attribute named in this list, the SDK removes it before sending the context to LaunchDarkly.

For example:

1
// All attributes marked private
2
const options = {
3
  allAttributesPrivate: true
4
};
5
client = ld.init('sdk-key-123abc', options);
6
7
// Two attributes marked private
8
const options = {
9
  privateAttributes: ['email', 'address']
10
};
11
client = ld.init('sdk-key-123abc', options);

You can also define a set of privateAttributes on the context object. For example:

1
import * as ld from '@launchdarkly/node-server-sdk';
2
3
const user: ld.LDContext = {
4
  kind: 'user',
5
  key: 'user-key-123abc',
6
  email: 'sandy@example.com',
7
  privateAttributes: ['email'],
8
};

When the SDK sends this context back to LaunchDarkly, it removes the email attribute.

In the PHP SDK there are two ways to define private attributes for the entire LaunchDarkly client:

• In the LaunchDarkly config, you can set all_attributes_private to true. If you enable this, the SDK removes all attributes except the key and kind from a context before sending the context to LaunchDarkly.
• In the LaunchDarkly config object, you can define a list of private_attribute_names. If any context has a custom or built-in attribute named in this list, the SDK removes it before sending the context to LaunchDarkly.

For example:

1
// All attributes marked private
2
$client = new LaunchDarkly\LDClient($sdkKey, ['all_attributes_private' => true]);
3
4
// Two attributes marked private
5
$client = new LaunchDarkly\LDClient($sdkKey, ['private_attribute_names' => ['name', 'email']]);

You can also mark attributes as private when building the context object by calling the equivalent “private” LDContextBuilder method.

For example:

1
$context = LDContext::builder('context-key-123abc')
2
    ->set('email', 'sandy@example.com')
3
    ->private('email')
4
    ->build();

When the SDK sends this context back to LaunchDarkly, it removes the email attribute.

In the Python SDK there are two ways to define private attributes for the LaunchDarkly client:

• In the LaunchDarkly config, you can set all_attributes_private to true. If you enable this, the SDK removes all context attributes for all contexts before sending the context to LaunchDarkly, except the key.
• In the LaunchDarkly config object, you can define a list of attributes in private_attributes. If any context has a custom or built-in attribute named in this list, the SDK removes it before sending the context to LaunchDarkly.

For example:

1
# All attributes marked private
2
config = Config(all_attributes_private=True)
3
4
# Two attributes marked private
5
config = Config(private_attributes=["name", "email"])

You can also mark attributes as private when building the context object by calling the private builder method. For example:

1
context = Context.builder("context-key-123abc") \
2
    .set("email", "sandy@example.com") \
3
    .private("email") \
4
    .build()

When the SDK sends this context back to LaunchDarkly, it removes the email attribute.

In the Ruby SDK there are two ways to define private attributes for the entire LaunchDarkly client:

• In the LaunchDarkly config, you can set all_attributes_private to true. If you enable this, the SDK removes all context attributes for all contexts before sending the context to LaunchDarkly, except the key.
• In the LaunchDarkly config object, you can define a list of private_attributes. If any context has a custom or built-in attribute named in this list, the SDK removes it before sending the context to LaunchDarkly.

For example:

1
# All attributes marked private
2
config = LaunchDarkly::Config.new({all_attributes_private: true})
3
4
# Two attributes marked private
5
config = LaunchDarkly::Config.new({private_attributes: ["name", "email"]})

You can also define a set of privateAttributes on the context object. For example:

1
context = LaunchDarkly::LDContext.create({
2
  key: "user-key-123abc",
3
  kind: "user",
4
  firstName: "Sandy",
5
  lastName: "Smith",
6
  email: "sandy@example.com",
7
  groups: ["Google", "Microsoft"],
8
  _meta: {
9
    privateAttributes: ['email']
10
  }
11
})

When the SDK sends this context back to LaunchDarkly, it removes the email attribute.

In the Rust SDK there are two ways to define private attributes for the entire LaunchDarkly client:

• In the LaunchDarkly config object, you can set all_attributes_private to true. If you enable this, the SDK removes all attributes for all contexts before sending the context to LaunchDarkly, except the key and kind.
• In the LaunchDarkly config object, you can define a list of private_attributes. If any contexts has an attribute named in this list, the SDK removes it before sending the context to LaunchDarkly.

For example:

1
// All attributes marked private
2
let config_builder = ConfigBuilder::new("sdk-key-123abc");
3
let mut processor_builder = EventProcessorBuilder::new();
4
processor_builder.all_attributes_private(true);
5
);
6
config_builder.event_processor(&processor_builder);
7
8
// Two attributes marked private
9
let config_builder = ConfigBuilder::new("sdk-key-123abc");
10
let mut processor_builder = EventProcessorBuilder::new();
11
processor_builder.private_attributes(
12
    vec!["email".into(), "address".into()]
13
        .into_iter()
14
        .collect(),
15
);
16
config_builder.event_processor(&processor_builder);

You can also define private attributes on the context object. For example:

1
let context = ContextBuilder::new("context-key-123abc")
2
    .set_value("email", "youremail@example.com".into())
3
    .add_private_attribute(Reference::new("email"))
4
    .build()?;

When the SDK sends this context back to LaunchDarkly, it removes the email attribute.

In the .NET AI SDK you can mark attributes as private when building the context object by calling Private() after setting the attribute on the context builder.

For example:

1
var context = Context.Builder("context-key-123abc")
2
    .Set("email", "sandy@example.com")
3
    .Private("email")
4
    .Build();

When the SDK sends this context back to LaunchDarkly, it removes the email attribute.

In the Go AI SDK you can mark attributes as private when building the context object by calling Private() after setting the attribute on the context builder.

For example:

1
import (
2
    "github.com/launchdarkly/go-sdk-common/v3/ldcontext"
3
)
4
5
context := ldcontext.NewBuilder("context-key-123abc").
6
    Kind("organization").
7
    Name("Global Health Services").
8
    SetString("email", "info@globalhealthexample.com").
9
    Private("email").
10
    Build()

When the SDK sends this context back to LaunchDarkly, it removes the email attribute.

In the Node.js (server-side) AI SDK you can define a set of privateAttributes on the context object.

Here’s how:

1
const context: LDContext = {
2
  kind: 'user',
3
  key: 'user-key-123abc',
4
  email: 'sandy@example.com',
5
  privateAttributes: ['email'],
6
};

When the SDK sends this context back to LaunchDarkly, it removes the email attribute.

In the Python AI SDK you can mark attributes as private when building the context object by calling the private builder method.

Here’s how:

1
context = Context.builder("context-key-123abc") \
2
    .set("email", "sandy@example.com") \
3
    .private("email") \
4
    .build()

When the SDK sends this context back to LaunchDarkly, it removes the email attribute.