// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using Microsoft.AspNetCore.Shared;
 
namespace Microsoft.AspNetCore.Http.Features;
 
/// <summary>
/// Provides information regarding TLS token binding parameters.
/// </summary>
/// <remarks>
/// TLS token bindings help mitigate the risk of impersonation by an attacker in the
/// event an authenticated client's bearer tokens are somehow exfiltrated from the
/// client's machine. See <see href="https://datatracker.ietf.org/doc/draft-popov-token-binding/"/>
/// for more information.
/// </remarks>
[Obsolete(Obsoletions.TlsTokenBindingFeatureMessage, DiagnosticId = Obsoletions.TlsTokenBindingFeatureDiagId, UrlFormat = Obsoletions.AspNetCoreDeprecate010Url)]
public interface ITlsTokenBindingFeature
{
    /// <summary>
    /// Gets the 'provided' token binding identifier associated with the request.
    /// </summary>
    /// <returns>The token binding identifier, or null if the client did not
    /// supply a 'provided' token binding or valid proof of possession of the
    /// associated private key. The caller should treat this identifier as an
    /// opaque blob and should not try to parse it.</returns>
    byte[] GetProvidedTokenBindingId();
 
    /// <summary>
    /// Gets the 'referred' token binding identifier associated with the request.
    /// </summary>
    /// <returns>The token binding identifier, or null if the client did not
    /// supply a 'referred' token binding or valid proof of possession of the
    /// associated private key. The caller should treat this identifier as an
    /// opaque blob and should not try to parse it.</returns>
    byte[] GetReferredTokenBindingId();
}