This is a working Go client for the Microsoft Graph API. It is actively maintained and has growing support for services and objects in Azure Active Directory.
See pkg.go.dev.
package main
import (
"context"
"fmt"
"log"
"os"
"github.com/manicminer/hamilton/auth"
"github.com/manicminer/hamilton/environments"
"github.com/manicminer/hamilton/msgraph"
)
var (
tenantId = os.Getenv("TENANT_ID")
tenantDomain = os.Getenv("TENANT_DOMAIN")
clientId = os.Getenv("CLIENT_ID")
clientCertificate = os.Getenv("CLIENT_CERTIFICATE")
clientCertPassword = os.Getenv("CLIENT_CERTIFICATE_PASSWORD")
clientSecret = os.Getenv("CLIENT_SECRET")
)
func main() {
ctx := context.Background()
authConfig := &auth.Config{
Environment: environments.Global,
TenantID: tenantId,
ClientID: clientId,
ClientSecret: clientSecret,
EnableClientSecretAuth: true,
}
authorizer, err := authConfig.NewAuthorizer(ctx, auth.MsGraph)
if err != nil {
log.Fatal(err)
}
client := msgraph.NewUsersClient(tenantId)
client.BaseClient.Authorizer = authorizer
users, _, err := client.List(ctx, "")
if err != nil {
log.Fatal(err)
}
if users == nil {
log.Fatalln("bad API response, nil result received")
}
for _, user := range *users {
fmt.Printf("%s: %s <%s>\n", *user.ID, *user.DisplayName, *user.UserPrincipalName)
}
}
Contributions are welcomed! Please note that clients must have tests that cover all methods where feasible.
Please raise a pull request on GitHub to submit contributions. Bug reports and feature requests are happily received.
Testing requires an Azure AD tenant and real credentials. You can authenticate with any supported method for the client tests, and the auth tests are split by authentication method.
Note that each client generally has a single test that exercises all methods. This is to help ensure that test objects are cleaned up where possible. Where tests fail, often objects will be left behind and should be cleaned up manually.
It's recommended to use an isolated tenant for testing and not a production tenant.
To run all the tests:
$ make test