Yoti 3.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package Yoti --version 3.0.0
NuGet\Install-Package Yoti -Version 3.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Yoti" Version="3.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Yoti --version 3.0.0
#r "nuget: Yoti, 3.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Yoti as a Cake Addin
#addin nuget:?package=Yoti&version=3.0.0

// Install Yoti as a Cake Tool
#tool nuget:?package=Yoti&version=3.0.0

Yoti .NET SDK

Welcome to the Yoti .NET SDK. This repo contains the tools and step by step instructions you need to quickly integrate your .NET back-end with Yoti so that your users can share their identity details with your application in a secure and trusted way.

Table of Contents

  1. Supported Frameworks - Frameworks supported by this .NET class library

  2. An Architectural View - High level overview of integration

  3. Enabling the SDK - How to install our SDK

  4. Client Initialisation - Description on setting up your SDK

  5. Profile Retrieval - Description on setting up profile

  6. Handling Users - Description on handling user log on's

  7. API Coverage - Attributes defined

  8. Support - Please feel free to reach out

Supported Frameworks

  • .NET Standard 1.6
  • .NET 4.5
  • .NET 4.6

An Architectural View

To integrate your application with Yoti, your back-end must expose a GET endpoint that Yoti will use to forward tokens. The endpoint can be configured in Yoti Hub when you create/update your application.

The image below shows how your application back-end and Yoti integrate in the context of a Login flow. Yoti SDK carries out for you steps 6, 7 ,8 and the profile decryption in step 9.

alt text

Yoti also allows you to enable user details verification from your mobile app by means of the Android (TBA) and iOS (TBA) SDKs. In that scenario, your Yoti-enabled mobile app is playing both the role of the browser and the Yoti app. By the way, your back-end doesn't need to handle these cases in a significantly different way. You might just decide to handle the User-Agent header in order to provide different responses for web and mobile clients.

Enabling the SDK

To install the Yoti NuGet package you will need to install NuGet. You can find instructions to do that here

To import the latest Yoti SDK into your project, enter the following command from NuGet Package Manager Console in Visual Studio:

Install-Package Yoti

For other installation methods, see nuget.org/packages/Yoti

Client Initialisation

The YotiClient is the SDK entry point. To initialise it you need include the following snippet inside your endpoint initialisation section:

const string sdkId = "your-sdk-id";
var privateKeyStream = System.IO.File.OpenText("path/to/your-application-pem-file.pem");
var yotiClient = new YotiClient(sdkId, privateKeyStream);

Where:

  • sdkId is the sdk identifier generated by Yoti Hub when you create (and then publish) your app. Note this is not your Application Identifier which is needed by your clientside code
  • path/to/your-application-pem-file.pem - When you create your app on Yoti Hub, your browser generates a .pem file. This is the path to that file.

You'll need to add the correct callback URL to one of the scenarios of your application from the "Applications" sections on Yoti Hub. You also need to make sure that the value of the data-yoti-scenario-id attribute in the Yoti button matches the id in the selected scenario.

Profile Retrieval

When your application receives a one time use token via the exposed endpoint (it will be assigned to a query string parameter named token), you can easily retrieve the user profile by adding the following to your endpoint handler:

var activityDetails = yotiClient.GetActivityDetails(oneTimeUseToken);

Or if you are in an asynchronous method:

var activityDetails = await yotiClient.GetActivityDetailsAsync(oneTimeUseToken);

Handling Users

The ActivityDetails includes a unique identifier for the user, named RememberMeId. You can use this to identify users returning to your application, but if the user completes a share with a different application, Yoti will assign a different RememberMeId. Applications registered to an organisation may also utilise an additional unique identifier named ParentRememberMeId. Use this to identify users returning to your organisation. It is consistent for a given user in all applications registered to a single organisation.

API Coverage

  • Activity Details
    • RememberMeId RememberMeId
    • ParentRememberMeId ParentRememberMeId
    • Timestamp Timestamp
    • Receipt ID ReceiptId
    • Profile Profile
      • Selfie Selfie
      • Selfie URI Selfie.GetBase64URI()
      • Given Names GivenNames
      • Family Name FamilyName
      • Full Name FullName
      • Mobile Number MobileNumber
      • Email Address EmailAddress
      • Age / Date of Birth DateOfBirth
      • Postal Address Address
      • Structured Postal Address StructuredPostalAddress
      • Gender Gender
      • Nationality Nationality
      • Age Verifications AgeVerifications
    • ApplicationProfile ApplicationProfile
      • Name Name
      • URL URL
      • Logo Logo
      • Receipt Background Color ReceiptBackgroundColor

Support

For any questions or support please email sdksupport@yoti.com. Please provide the following to get you up and working as quickly as possible:

  • Computer type
  • OS version
  • Version of .NET being used
  • Screenshot

Once we have answered your question we may contact you again to discuss Yoti products and services. If you’d prefer us not to do this, please let us know when you e-mail.

For further documentation, see https://www.yoti.com/developers/documentation/?csharp For further documentation, see https://developers.yoti.com/yoti-app/web-integration

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp1.0 was computed.  netcoreapp1.1 was computed.  netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard1.6 is compatible.  netstandard2.0 was computed.  netstandard2.1 was computed. 
.NET Framework net45 is compatible.  net451 is compatible.  net452 is compatible.  net46 is compatible.  net461 is compatible.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen30 was computed.  tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Yoti:

Package Downloads
Yoti.Sandbox

Yoti .NET SDK Sandbox

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.15.0 1,093 2/13/2024
3.14.0 14,299 4/21/2023
3.12.0 18,163 7/28/2022
3.11.0 5,294 5/3/2022
3.10.0 20,503 12/3/2021
3.9.0 5,005 3/23/2021
3.8.0 9,777 11/3/2020
3.7.0 1,211 10/21/2020
3.6.0 3,812 7/9/2020
3.5.1 1,643 6/4/2020
3.5.0 938 6/3/2020
3.4.0 1,082 4/16/2020
3.3.1 7,693 2/12/2020
3.3.0 1,490 1/6/2020
3.2.0 1,243 12/4/2019
3.1.0 1,559 10/23/2019
3.0.0 994 10/9/2019
2.8.0 2,402 10/30/2018
2.7.0 1,657 7/12/2018
2.6.0 1,582 6/6/2018
2.4.0 1,618 3/22/2018
2.3.0 1,323 3/13/2018
2.2.1 1,348 2/21/2018
2.2.0 1,443 10/23/2017
2.1.1 1,425 10/12/2017
2.1.0 1,499 10/3/2017