feat: add SSO certificate support (#779)

* feat: add SSO certificate support

* fix: correct filename in comment for SSO certificate API

Author: neilmartin83

examples/sso_certificate/CreateSSOCertificate/CreateSSOCertificate.go

@@ -0,0 +1,33 @@
+package main
+
+import (
+	"fmt"
+	"log"
+
+	"github.com/deploymenttheory/go-api-sdk-jamfpro/sdk/jamfpro"
+)
+
+func main() {
+	// Define the path to the JSON configuration file
+	configFilePath := "/Users/Shared/GitHub/go-api-sdk-jamfpro/localtesting/clientconfig.json"
+
+	client, err := jamfpro.BuildClientWithConfigFile(configFilePath)
+	if err != nil {
+		log.Fatalf("Failed to initialize Jamf Pro client: %v", err)
+	}
+
+	// Create new SSO certificate
+	newCert, err := client.CreateSSOCertificate()
+	if err != nil {
+		log.Fatalf("Error generating new SSO certificate: %v", err)
+	}
+
+	fmt.Println("New SSO certificate generated successfully!")
+	fmt.Printf("Certificate Type: %s\n", newCert.Keystore.Type)
+	fmt.Printf("Setup Type: %s\n", newCert.Keystore.KeystoreSetupType)
+
+	// Print validation status for each key
+	for _, key := range newCert.Keystore.Keys {
+		fmt.Printf("Key ID: %s, Valid: %v\n", key.ID, key.Valid)
+	}
+}

examples/sso_certificate/DeleteSSOCertificate/DeleteSSOCertificate.go

@@ -0,0 +1,27 @@
+package main
+
+import (
+	"fmt"
+	"log"
+
+	"github.com/deploymenttheory/go-api-sdk-jamfpro/sdk/jamfpro"
+)
+
+func main() {
+	// Define the path to the JSON configuration file
+	configFilePath := "/Users/Shared/GitHub/go-api-sdk-jamfpro/localtesting/clientconfig.json"
+
+	// Initialize the Jamf Pro client
+	client, err := jamfpro.BuildClientWithConfigFile(configFilePath)
+	if err != nil {
+		log.Fatalf("Failed to initialize Jamf Pro client: %v", err)
+	}
+
+	// Delete the SSO certificate
+	err = client.DeleteSSOCertificate()
+	if err != nil {
+		log.Fatalf("Error deleting SSO certificate: %v", err)
+	}
+
+	fmt.Println("SSO certificate successfully deleted")
+}

examples/sso_certificate/GetSSOCertificate/GetSSOCertificate.go

@@ -0,0 +1,36 @@
+package main
+
+import (
+	"fmt"
+	"log"
+
+	"github.com/deploymenttheory/go-api-sdk-jamfpro/sdk/jamfpro"
+)
+
+func main() {
+	// Define the path to the JSON configuration file
+	configFilePath := "/Users/Shared/GitHub/go-api-sdk-jamfpro/localtesting/clientconfig.json"
+
+	// Initialize the Jamf Pro client
+	client, err := jamfpro.BuildClientWithConfigFile(configFilePath)
+	if err != nil {
+		log.Fatalf("Failed to initialize Jamf Pro client: %v", err)
+	}
+
+	// Get SSO certificate information
+	certInfo, err := client.GetSSOCertificate()
+	if err != nil {
+		log.Fatalf("Error fetching SSO certificate information: %v", err)
+	}
+
+	// Print certificate details
+	fmt.Printf("Certificate Type: %s\n", certInfo.Keystore.Type)
+	fmt.Printf("Keystore Filename: %s\n", certInfo.Keystore.KeystoreFileName)
+	fmt.Printf("Setup Type: %s\n", certInfo.Keystore.KeystoreSetupType)
+
+	if certInfo.KeystoreDetails != nil {
+		fmt.Printf("Issuer: %s\n", certInfo.KeystoreDetails.Issuer)
+		fmt.Printf("Subject: %s\n", certInfo.KeystoreDetails.Subject)
+		fmt.Printf("Expiration: %s\n", certInfo.KeystoreDetails.Expiration)
+	}
+}

sdk/jamfpro/jamfproapi_sso_certificate.go

@@ -1,8 +1,87 @@
 // jamfproapi_sso_certificate.go
-// Jamf Pro Api - SSO Certificate
-// api reference: https://developer.jamf.com/jamf-pro/reference/get_v2-sso-cert
-// Jamf Pro API requires the structs to support a JSON data structure.
-
 package jamfpro
 
-// TODO - Awaiting some investigation around what this endpoint actually returns (json or cert or ???)
+import (
+	"fmt"
+)
+
+const (
+	uriSSOCert = "/api/v2/sso/cert"
+)
+
+// Resource structures
+type ResourceSSOCertKeystore struct {
+	Key               string            `json:"key,omitempty"`
+	Keys              []ResourceCertKey `json:"keys,omitempty"`
+	Type              string            `json:"type,omitempty"`
+	KeystoreFileName  string            `json:"keystoreFileName,omitempty"`
+	KeystoreSetupType string            `json:"keystoreSetupType,omitempty"`
+}
+
+type ResourceCertKey struct {
+	ID    string `json:"id,omitempty"`
+	Valid bool   `json:"valid"`
+}
+
+type ResourceSSOKeystoreDetails struct {
+	Keys         []string `json:"keys,omitempty"`
+	Issuer       string   `json:"issuer,omitempty"`
+	Subject      string   `json:"subject,omitempty"`
+	Expiration   string   `json:"expiration,omitempty"`
+	SerialNumber int      `json:"serialNumber,omitempty"`
+}
+
+type ResourceSSOKeystoreResponse struct {
+	Keystore        ResourceSSOCertKeystore     `json:"keystore,omitempty"`
+	KeystoreDetails *ResourceSSOKeystoreDetails `json:"keystoreDetails,omitempty"`
+}
+
+// GetSSOCertificate gets the certificate currently configured for use with SSO
+func (c *Client) GetSSOCertificate() (*ResourceSSOKeystoreResponse, error) {
+	endpoint := uriSSOCert
+
+	var certResponse ResourceSSOKeystoreResponse
+	resp, err := c.HTTP.DoRequest("GET", endpoint, nil, &certResponse)
+	if err != nil {
+		return nil, fmt.Errorf(errMsgFailedGet, "sso certificate", err)
+	}
+
+	if resp != nil && resp.Body != nil {
+		defer resp.Body.Close()
+	}
+
+	return &certResponse, nil
+}
+
+// CreateSSOCertificate generates a new certificate for signing SSO requests
+func (c *Client) CreateSSOCertificate() (*ResourceSSOKeystoreResponse, error) {
+	endpoint := uriSSOCert
+
+	var certResponse ResourceSSOKeystoreResponse
+	resp, err := c.HTTP.DoRequest("POST", endpoint, nil, &certResponse)
+	if err != nil {
+		return nil, fmt.Errorf(errMsgFailedCreate, "sso certificate", err)
+	}
+
+	if resp != nil && resp.Body != nil {
+		defer resp.Body.Close()
+	}
+
+	return &certResponse, nil
+}
+
+// DeleteSSOCertificate deletes the currently configured certificate used by SSO
+func (c *Client) DeleteSSOCertificate() error {
+	endpoint := uriSSOCert
+
+	resp, err := c.HTTP.DoRequest("DELETE", endpoint, nil, nil)
+	if err != nil {
+		return fmt.Errorf(errMsgFailedDelete, "sso certificate", err)
+	}
+
+	if resp != nil && resp.Body != nil {
+		defer resp.Body.Close()
+	}
+
+	return nil
+}