---
title: "Details of Security Object by Name"
slug: "dsm-example-code-details-of-security-object-by-name"
updated: 2024-12-10T17:33:54Z
published: 2024-12-10T17:33:54Z
canonical: "support.fortanix.com/dsm-example-code-details-of-security-object-by-name"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.fortanix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Details of Security Object by Name

The `getSecurityObjects` API can also be used to lookup keys by name. The first parameter of this method restricts the returned value to only the Security-object with the requested name.

- [C#](/docs/dsm-example-code-details-of-security-object-by-name#tabs-1)
- [Go](/docs/dsm-example-code-details-of-security-object-by-name#tabs-2)
- [Java](/docs/dsm-example-code-details-of-security-object-by-name#tabs-3)
- [Python](/docs/dsm-example-code-details-of-security-object-by-name#tabs-4)
- [REST API using curl](/docs/dsm-example-code-details-of-security-object-by-name#tabs-5)

### C#

```bash
SecurityObjectsApi sObjectApi = new SecurityObjectsApi();
List<KeyObject> sObjects = sObjectApi.GetSecurityObjects(name : "example-key");
KeyObject matched = sObjects[0];
```

### Go

```bash
keyName := "example-key"
sobjectDescriptor := sdkms.SobjectDescriptor {
Name: &keyName,
} 
key, err := client.GetSobject(ctx, nil, &sobjectDescriptor)
```

### Java

```bash
List sobjects = sobjectsApi.getSecurityObjects("example-key", null, null, null);
KeyObject matched = sobjects.get(0); // Max 1 object will be there in the result list
```

### Python

```bash
api_instance = sdkms.v1. SecurityObjectsApi(api_client=client)
sobjects = api_instance.get_security_objects(name = "example-key")
matched = sobjects[0]
```

### REST API using curl

```bash
curl <Endpoint URL>/crypto/v1/keys?name=example-key -H 'Authorization: Bearer YhXwwa-6C...ig5g'
```

A security object is any datum stored in DSM (for example a key, a certificate, a password, or other security objects). Each security object is assigned to exactly one group. users and applications assigned to the group have permission to see the security object and to perform operations on it.

## Related

- [User Authentication](/dsm-example-code-user-authentication.md)
- [Key Lifecycle Management](/fortanix-data-security-manager-key-lifecycle-management.md)
- [Wrapping a Key](/dsm-example-code-wrapping-a-key.md)
- [Generating Security Objects](/dsm-generating-security-objects.md)