SAML Auth

This authentication option uses Microsoft Online Security Token Service https://login.microsoftonline.com/extSTS.srf and SAML tokens in order to obtain authentication cookie.
Struct
type AuthCnfg struct {
  // SPSite or SPWeb URL, which is the context target for the API calls
  SiteURL string `json:"siteUrl"`
  // Username for SharePoint Online, e.g. `[user]@[company].onmicrosoft.com`
  Username string `json:"username"`
  // User or App password
  Password string `json:"password"`
}
JSON
private.json sample:
{
  "siteUrl": "https://contoso.sharepoint.com/sites/test",
  "username": "[email protected]",
  "password": "this-is-not-a-real-password"
}
Code sample
package main
​
import (
	"log"
	// "os"
​
	"github.com/koltyakov/gosip"
	strategy "github.com/koltyakov/gosip/auth/saml"
)
​
func main() {
	// authCnfg := &strategy.AuthCnfg{
	// 	SiteURL:  os.Getenv("SPAUTH_SITEURL"),
	// 	Username: os.Getenv("SPAUTH_USERNAME"),
	// 	Password: os.Getenv("SPAUTH_PASSWORD"),
	// }
	// or using `private.json` creds source
​
	authCnfg := &strategy.AuthCnfg{}
	configPath := "./config/private.json"
	if err := authCnfg.ReadConfig(configPath); err != nil {
		log.Fatalf("unable to get config: %v", err)
	}
​
	client := &gosip.SPClient{AuthCnfg: authCnfg}
	// use client in raw requests or bind it with Fluent API ...
}

Authentication strategies - Previous

Strategies

AddIn Only

Last modified 2yr ago

Export as PDF

Copy link

On this page

Struct

JSON

Code sample