(VB.NET UWP/WinRT) SharePoint Online Authentication

Demonstrates how to authenticate with SharePoint Online. The end result of authentication is to establish an HTTP cookie, named "SPOIDCRL", that contains a binary security token to be sent in subsequent SharePoint HTTPS requests.

The SPOIDCRL cookie can be persisted to a file and re-used in subsequent application runs.

Important: This example uses a method, SharePointOnlineAuth, that is introduced in Chilkat v9.5.0.73.

Also Important: Chilkat realizes there may be cases where your situation is such that it does not work, and something additional is required to make it work. If the example does not work out-of-the-box, please send email to support@chilkatsoft.com. The information logged to the LastErrorText property has been carefully crafted to help solve problems quickly. Also, the JSON argument to the SharePointOnlineAuth method provides a means to include additional information, whatever it may be, to handle future unknown situations.

Chilkat Universal Windows Platform (UWP) / WinRT Downloads Chilkat for the Universal Windows Platform (UWP)

' This requires the Chilkat API to have been previously unlocked.
' See Global Unlock Sample for sample code.

Dim success As Boolean
Dim http As New Chilkat.Http

' Change these things...
' Make sure to use "https" and end in a "/".
Dim siteUrl As String = "https://mydomain.sharepoint.com/"
' The username is an email address.
Dim username As String = "username@mydomain.com"

' The jsonExtra is for future use, if extra information is required for particular integrations.
Dim jsonExtra As New Chilkat.JsonObject

Dim ssPassword As New Chilkat.SecureString
ssPassword.Append("mypassword")

' Set properties to save/send cookies, and specify a cookie directory.
' If the CookieDir = "memory", then the SPOIDCRL cookie is persisted in memory for this HTTP object instance only.
' To persist the SharePoint authentication cookie for other HTTP objects, and for future application runs,
' set the CookieDir equal to a directory path (not a specific file path, but a directory path where cookie files
' are to be created).
http.SaveCookies = True
http.SendCookies = True
http.CookieDir = "memory"

' The SharePointOnlineAuth method is introduced in Chilkat v9.5.0.73
success = Await http.SharePointOnlineAuthAsync(siteUrl,username,ssPassword,jsonExtra)
If (success = False) Then
    Debug.WriteLine(http.LastErrorText)
    Exit Sub
End If



Debug.WriteLine("Success! We have the SPOIDCRL cookie...")


' SharePoint authenticated requests may now be sent because the authentication cookie is automatically included.
' For example:
Dim sbResponseXml As New Chilkat.StringBuilder
' If your Sharepoint site is within a site collection, then use "https://mydomain.sharepoint.com/sites/teamA/_api/web/GetFolderByServerRelativeUrl('/sites/teamA/Documents')/Files" where "teamA" is the name of the site.
success = Await http.QuickGetSbAsync("https://mydomain.sharepoint.com/_api/web/GetFolderByServerRelativeUrl('/Documents')/Files",sbResponseXml)
If (success = False) Then
    Debug.WriteLine(http.LastErrorText)
    Exit Sub
End If


Debug.WriteLine("Response status code = " & http.LastStatus)

Dim xml As New Chilkat.Xml
xml.LoadSb(sbResponseXml,True)
Debug.WriteLine(xml.GetXml())