KanBo.Client 1.0.3

Namepsaces

KanBo.Client - Main namespace containg all helpers for creating tokens and calling api
KanBo.Api - Namespace containg all api methods and data structures
        .GetData - methods that return kanbo data
        .Action - methods that make some actions in kanbo
        .Data - kanbo data types used for varoius calls nad responses

General properties required for creating kanbo token and requester

string kanboCertificatePath = @"F:\Certs\SomeGeneratedCertificate.pfx";    
string kanboCertificatePassword = @"$#testPassWord123#$";    
or
string thumbprint = "06 ac 19 8c 89 c3 f7 cb bd 9d 49 f8 64 15 42 2a ea 15 da 5e".Replace(" ", "");

string kanboUrl = @"https://somekanbo.azurewebsites.net";    
string kanboCertificateIssuer = "kanbo-client";    

Token properties

Properties required for creating user impersonating token

        int kanboUserId = 1; // Id of a user that will be impersonated 
        string kanboUserLogin = "t.name@somesp.onmicrosoft.com"; // Login of a user that will be impersonated
        string kanboLoginType = "upn-graph"; // Login type - used only in .AsLogin() operation
        

Available types:

.AsService() - service token
.AsServiceWithEmail("name@test.onmicrosoft.com") - service token with email impersonation
.AsKanBoUserId(kanboUserId) - user token
.AsLogin(kanboUserLogin, kanboLoginType) - login token
.AsEmail("name@test.onmicrosoft.com") - email token

//AsLogin has build in wrappers showed below

.AsSpOnpremLogin("i:0#.w|domain/login") 
.AsSpOnlineLogin("i:0#.f|membership|login@domain.onmicrosoft.com")
.AsSpOnlineUpn("name@test.onmicrosoft.com")
.AsO365UserId("2980b5dc-6c76-4867-9808-7fd00ae234c4")
.AsO365Upn("name@test.onmicrosoft.com")

//AsEmail has build in wrapper showed below

.AsServiceWithEmail("name@test.onmicrosoft.com")

Extra Token options

.WithAuthRoles(string[] roles) - adding roles for token

Create certificate object

Example 1

    var kanboCertificate = new X509Certificate2(kanboCertificatePath, kanboCertificatePassword);    

Example 2

    var thumbprint = "06 ac 19 8c 89 c3 f7 cb bd 9d 49 f8 64 15 42 2a ea 15 da 5e".Replace(" ", "");
    using var store = new X509Store(StoreName.My, StoreLocation.LocalMachine);
    store.Open(OpenFlags.ReadOnly);
    var certificates = store.Certificates.Find(X509FindType.FindByThumbprint, thumbprint, false);

Creating requester

var req = ApiBuilder.New.WithJsonApi(kanboUrl).WithIssuer(kanboCertificateIssuer)
            .WithRsaSignature(kanboCertificate).AsService().Build();
        

Calling api

Task.Run(async () =>
{
    /* Get board with Id=1 */
    var board = await req.GetData(new KanBo.Api.GetData.Board {Id = 1});
}).Wait();

Using Rich text editor

//Each line of text is equal to new rich text block
var rtEd = new KanBo.Client.Helpers.RTEditor();
RichText rt = rtEd
    .CreateTextBlock("Some Text").CreateBold(0,4) //line of text in which 'Some' is bold
    .CreateCheckedItemBlock("Done item").CreateBold(0,4).GetRichText() //in new line add checked item with 'Done' bold
    .CreateEmptyLine() //create an empty line
    .CreateTextBlock("Some Text").CreateItalic(5,4) //new line with text in wich 'Text' is italic
    .GetRichText();

Using Config Manager to generate json config for KanBo

var cm = new ConfigManager()
            .SetIssuer("ui-path-actions-cert")
            .AddCertFromFile(kanboConfigCertificatePath)
            .AddServiceMapper("UiPathservice", new string[2] {"service","external-services"})
            .AddUserMapper()
            .AddEmailMapper(new string[1] {"external-services"})
            .AddLoginMapper(new string[1] {"*"})
            .GetJsonConfig();