feat: add OIDC Direct IdP Login URL retrieval functionality /v1/oidc/direct-idp-login-url (11.19) (#859)

* fix: refactor Jamf Protect functions

* feat: add OIDC Direct IdP Login URL retrieval functionality /v1/oidc/direct-idp-login-url

* chore: update API reference for OIDC Direct IdP Login URL

Author: neilmartin83

examples/oidc/GetDirectURLForOIDCLogin/GetDirectURLForOIDCLogin.go

@@ -0,0 +1,33 @@
+package main
+
+import (
+	"encoding/json"
+	"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 with the HTTP client configuration
+	client, err := jamfpro.BuildClientWithConfigFile(configFilePath)
+	if err != nil {
+		log.Fatalf("Failed to initialize Jamf Pro client: %v", err)
+	}
+
+	// Get the OIDC Direct IdP Login URL
+	oIDCDirectIdPLoginURLResponse, err := client.GetDirectURLForOIDCLogin()
+	if err != nil {
+		log.Fatalf("Error retrieving OIDC direct IdP login URL: %v", err)
+	}
+
+	// Pretty print the response in JSON
+	oIDCDirectIdPLoginURLJSON, err := json.MarshalIndent(oIDCDirectIdPLoginURLResponse, "", "    ")
+	if err != nil {
+		log.Fatalf("Error marshaling OIDC direct IdP login URL data: %v", err)
+	}
+	fmt.Println("OIDC Direct IdP Login URL Details:\n", string(oIDCDirectIdPLoginURLJSON))
+}

sdk/jamfpro/jamfproapi_oidc.go

@@ -1,6 +1,7 @@
 // jamfproapi_oidc.go
 // Jamf Pro Api - OIDC
 // api reference: https://developer.jamf.com/jamf-pro/reference/get_v1-oidc-public-key
+// https://developer.jamf.com/jamf-pro/reference/get_v1-oidc-direct-idp-login-url
 // Jamf Pro Api requires the structs to support an JSON data structure.
 
 package jamfpro
@@ -9,7 +10,12 @@ import "fmt"
 
 const uriOIDC = "/api/v1/oidc"
 
-// ResponseOIDCPublicKeyrepresents the response structure for the OIDC public key.
+// ResponseOIDCDirectIdPLoginURL represents the response structure for the OIDC Direct IdP Login URL.
+type ResponseOIDCDirectIdPLoginURL struct {
+	URL string `json:"url"`
+}
+
+// ResponseOIDCPublicKey represents the response structure for the OIDC public key.
 type ResponseOIDCPublicKey struct {
 	Keys []ResourceOIDCKey `json:"keys"`
 }
@@ -36,6 +42,23 @@ type ResponseOIDCRedirectURL struct {
 	RedirectURL string `json:"redirectUrl"`
 }
 
+// GetDirectURLForOIDCLogin retrieves the direct IdP login URL for OIDC.
+func (c *Client) GetDirectURLForOIDCLogin() (*ResponseOIDCDirectIdPLoginURL, error) {
+	endpoint := fmt.Sprintf("%s/direct-idp-login-url", uriOIDC)
+
+	var response ResponseOIDCDirectIdPLoginURL
+	resp, err := c.HTTP.DoRequest("GET", endpoint, nil, &response)
+	if err != nil {
+		return nil, fmt.Errorf("failed to get OIDC direct IdP login URL: %v", err)
+	}
+
+	if resp != nil && resp.Body != nil {
+		defer resp.Body.Close()
+	}
+
+	return &response, nil
+}
+
 // GetPublicKeyOfOIDCKeystore retrieves the public key of the keystore used for signing OIDC messages as a JWT.
 func (c *Client) GetPublicKeyOfOIDCKeystore() (*ResponseOIDCPublicKey, error) {
 	endpoint := fmt.Sprintf("%s/public-key", uriOIDC)