Basic authentication

Basic Authentication uses a ServiceNow username and password to authenticate API calls. it's simple to configure, but use it primarily for development, testing, or controlled system‑to‑system integrations.

Objective

Configure and use Basic Authentication with the Service‑Now SDK using values provided by your ServiceNow administrator.

Required values

Your administrator must provide:

Value	Description
Service‑Now URL	Base URL of the instance
Username	Integration user’s username
Password	Integration user’s password

SDK flow

flowchart TD
    A[App Code] --> B[BasicAuthenticationProvider]
    B --> C{Validate Input}
    C -->|Valid| D[Build ""username:password"" string]
    C -->|Invalid| E[Return Error]

    D --> F[Base64 Encode Credentials]
    F --> G[Add Authorization Header to RequestInformation]
    G --> H[Kiota Request Adapter]

Initialize the SDK

import (
    "log"

    credentials "github.com/michaeldcanady/service-now-sdk/credentials"
    servicenow "github.com/michaeldcanady/service-now-sdk"
)

func main() {
    clientOpts := []credentials.ServiceNowServiceClientOption{
        servicenow.WithAuthenticationProvider(
            credentials.NewBasicAuthenticationProvider(username, password),
        ),
        servicenow.WithInstance("{instance}"),
    }

    client, err := servicenow.NewServiceNowServiceClient(clientOpts...)
    if err != nil {
        log.Fatal(err)
    }

    // Client is now authenticated and ready to use
}