DeviceAuth_SslCtxFunc Function

Header: #include <tlsutils/deviceauth_curl.h>

Performs device authentication for TLS connections. Note that although the curl function names include SSL, Azure Sphere uses TLS for authentication.

An application's custom libcurl function calls DeviceAuth_SslCtxFunc to perform device authentication of TLS connections. Your custom function must call DeviceAuth_SslCtxFunc to perform the authentication, but may also perform other tasks related to authentication.

DeviceAuthSslResult DeviceAuth_SslCtxFunc(void *sslctx);

Parameters

  • sslctx Pointer to the context that is passed by the application's SSL callback.

Return value

Returns a value of the DeviceAuthSslResult enumeration, which provides detailed information about the failure.

Examples

Connect to web services contains an example and additional information.

Application manifest requirements

To access individual hosts or domains, your application must identify them in the AllowedConnections field of the application manifest. If the application uses mutual authentication, the DeviceAuthentication field of the manifest must include the Azure Sphere tenant ID.