AspNetCore.Docs/aspnetcore/security/data-protection/extensibility/misc-apis.md

---
title: Miscellaneous APIs
author: rick-anderson
description: 
keywords: ASP.NET Core,
ms.author: riande
manager: wpickett
ms.date: 10/14/2016
ms.topic: article
ms.assetid: 512c6ba7-88ec-47e4-a656-6b30350b34e6
ms.technology: aspnet
ms.prod: asp.net-core
uid: security/data-protection/extensibility/misc-apis
---
# Miscellaneous APIs

<a name=data-protection-extensibility-mics-apis></a>

>[!WARNING]
> Types that implement any of the following interfaces should be thread-safe for multiple callers.

## ISecret

The ISecret interface represents a secret value, such as cryptographic key material. It contains the following API surface.

* Length : int

* Dispose() : void

* WriteSecretIntoBuffer(ArraySegment<byte> buffer) : void

The WriteSecretIntoBuffer method populates the supplied buffer with the raw secret value. The reason this API takes the buffer as a parameter rather than returning a byte[] directly is that this gives the caller the opportunity to pin the buffer object, limiting secret exposure to the managed garbage collector.

The Secret type is a concrete implementation of ISecret where the secret value is stored in in-process memory. On Windows platforms, the secret value is encrypted via [CryptProtectMemory](https://msdn.microsoft.com/library/windows/desktop/aa380262(v=vs.85).aspx).
Add docfx content 2016-10-29 01:35:15 +08:00			`---`
remove \| MS Docs (#3612) 2017-07-01 07:47:15 +08:00			`title: Miscellaneous APIs`
Add docfx content 2016-10-29 01:35:15 +08:00			`author: rick-anderson`
keywords and decription meta-data 2016-11-18 04:13:02 +08:00			`description:`
			`keywords: ASP.NET Core,`
Add docfx content 2016-10-29 01:35:15 +08:00			`ms.author: riande`
			`manager: wpickett`
			`ms.date: 10/14/2016`
			`ms.topic: article`
			`ms.assetid: 512c6ba7-88ec-47e4-a656-6b30350b34e6`
title + meta on technology 2016-11-17 08:24:57 +08:00			`ms.technology: aspnet`
Bulk metadata fix (#2871) * meta data fix * Revert "meta data fix" This reverts commit ba3688347667594a0967b08196cbb5308500a217. * meta data fix2 * test * Update owin-oauth-20-authorization-server.md * Update api-ref.md * Update api-ref.md * test * test2 2017-03-03 08:50:36 +08:00			`ms.prod: asp.net-core`
Add docfx content 2016-10-29 01:35:15 +08:00			`uid: security/data-protection/extensibility/misc-apis`
			`---`
			`# Miscellaneous APIs`

			`<a name=data-protection-extensibility-mics-apis></a>`

			`>[!WARNING]`
			`> Types that implement any of the following interfaces should be thread-safe for multiple callers.`

			`## ISecret`

			`The ISecret interface represents a secret value, such as cryptographic key material. It contains the following API surface.`

			`* Length : int`

			`* Dispose() : void`

			`* WriteSecretIntoBuffer(ArraySegment<byte> buffer) : void`

			`The WriteSecretIntoBuffer method populates the supplied buffer with the raw secret value. The reason this API takes the buffer as a parameter rather than returning a byte[] directly is that this gives the caller the opportunity to pin the buffer object, limiting secret exposure to the managed garbage collector.`

remove /en-us/ (#3670) 2017-07-11 02:20:50 +08:00			`The Secret type is a concrete implementation of ISecret where the secret value is stored in in-process memory. On Windows platforms, the secret value is encrypted via [CryptProtectMemory](https://msdn.microsoft.com/library/windows/desktop/aa380262(v=vs.85).aspx).`