HandleSAMLCallback

Complete login process with the information provided by the SAML identity provider in previous step.

rpc HandleSAMLCallback

user_api.v1.HandleSAMLCallback

Complete login process with the information provided by the SAML identity provider in previous step.

requests HandleSAMLCallbackRequest

user_api.v1.HandleSAMLCallbackRequest

FieldTypeDescription
saml_responsestringSAML RFC7522 response from the identity provider.
relay_statestringURL for the identity provider to send the response.
resp, _ := userApiService.HandleSAMLCallback(ctx, &v1.HandleSAMLCallbackRequest{
  RelayState: "RELAY_STATE",
  SamlResponse: "SAML_RESPONSE",
})
fmt.Println(resp)
const handlesamlcallbackrequest = new HandleSAMLCallbackRequest();
handlesamlcallbackrequest.setRelayState("RELAY_STATE");
handlesamlcallbackrequest.setSamlResponse("SAML_RESPONSE");

service.handleSAMLCallback(handlesamlcallbackrequest, (err, value:HandleSAMLCallbackResponse|null) => {
    const resp = JSON.stringify(err ? err : value);
    console.log("received ", resp);
})
using System;
using Grpc.Core;
using UserApi.V1;

namespace main
{
  class Program
  {
    static void Main(string[] args)
    {
      Channel channel = new Channel("user-mgmt.YOUR_SANDBOX_ID.knoxnetworks.io:443", ChannelCredentials.Insecure); 
      var client = new UserApiService.UserApiServiceClient(channel); 
      var headers = new Metadata();
      var handleSAMLCallbackRequest = new HandleSAMLCallbackRequest{
        RelayState = "RELAY_STATE",
        SamlResponse = "SAML_RESPONSE",
      };
      var reply = client.HandleSAMLCallback(handleSAMLCallbackRequest, headers);
      Console.WriteLine("Response: " + reply);
      channel.ShutdownAsync().Wait();
    }
  }
}
package demo;

import io.grpc.Channel;
import io.grpc.ManagedChannel;
import io.grpc.ManagedChannelBuilder;
import user_api.v1.User.HandleSAMLCallbackRequest;
import user_api.v1.User.HandleSAMLCallbackResponse;
import user_api.v1.UserApiServiceGrpc;

public class App {
  public static void main(String[] args) {
    ManagedChannel channel = ManagedChannelBuilder
      .forAddress("user-mgmt.YOUR_SANDBOX_ID.knoxnetworks.io", 443)
      .usePlaintext()
      .build();
    UserApiServiceGrpc.UserApiServiceBlockingStub blockStub =
        UserApiServiceGrpc.newBlockingStub(channel);
    
    HandleSAMLCallbackRequest req_HandleSAMLCallbackRequest =
        HandleSAMLCallbackRequest.newBuilder()
          .setRelayState("RELAY_STATE")
          .setSamlResponse("SAML_RESPONSE")
          .build();
    HandleSAMLCallbackResponse resp = blockStub.handleSAMLCallback(req_HandleSAMLCallbackRequest);
    System.out.println(resp);
    channel.shutdown();
  }
}
const handlesamlcallbackrequest = new HandleSAMLCallbackRequest();
handlesamlcallbackrequest.setRelayState("RELAY_STATE");
handlesamlcallbackrequest.setSamlResponse("SAML_RESPONSE");

service.handleSAMLCallback(handlesamlcallbackrequest, (err, value) => {
    const resp = JSON.stringify(err ? err : value);
    console.log("received ", resp);
})
extern crate grpc-sdks;
use tonic::transport::Channel;

use grpc-sdks::user_api::v1::user_api_service_client::UserApiServiceClient;
use grpc-sdks::user_api::v1::HandleSAMLCallbackRequest;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
  let channel = Channel::from_static("user-mgmt.YOUR_SANDBOX_ID.knoxnetworks.io")
    .connect()
    .await?;
  let mut client = UserApiServiceClient::new(channel); 

  let request = tonic::Request::new(
    HandleSAMLCallbackRequest{
      relay_state: String::from("RELAY_STATE"),
      saml_response: String::from("SAML_RESPONSE")
    });
// sending request and waiting for response
  let response = client.handle_saml_callback(request).await?.into_inner();
  println!("RESPONSE={:?}", response);
  Ok(())
}
package app

import io.grpc.ManagedChannelBuilder
import user_api.v1.User.HandleSAMLCallbackRequest
import user_api.v1.User.HandleSAMLCallbackResponse
import user_api.v1.UserApiServiceGrpc

fun main() {
    val channel = ManagedChannelBuilder
            .forAddress("user-mgmt.YOUR_SANDBOX_ID.knoxnetworks.io", 443)
            .usePlaintext()
            .build()
    var blockStub = UserApiServiceGrpc.newBlockingStub(channel)
    
    val req_HandleSAMLCallbackRequest = HandleSAMLCallbackRequest.newBuilder()
          .setRelayState("RELAY_STATE")
          .setSamlResponse("SAML_RESPONSE")
          .build()
    val resp = blockStub.handleSAMLCallback(req_HandleSAMLCallbackRequest)
    println(resp)
    channel.shutdown()
}


returns HandleSAMLCallbackResponse

user_api.v1.HandleSAMLCallbackResponse

FieldTypeDescription
userUserUser object of the subject.
auth_tokenAuthTokenOAuth2 RFC6749 Access Token
instance_namestringUsed by client to identify application instance initiating authentication.
request_originstringUsed by client to identify origin of the request initiating authentication.
{
  "user": {
    "uuid": "UUID",
    "first_name": "John",
    "last_name": "Doe",
    "email": "[email protected]",
    "role": 0,
    "avatar": "AVATAR_URL",
    "phone": "+1 555 555 5555",
    "dids": [
      "did:method-name:zDIDMultibase58Encoded",
      "did:method-name:zDIDMultibase58Encoded"
    ],
    "external_ids": [
      {
        "key": "KEY1",
        "value": "VALUE1"
      },
      {
        "key": "KEY2",
        "value": "VALUE2"
      }
    ],
    "metadata": {
      "fields": []
    },
    "account": "15436675"
  },
  "auth_token": {
    "token": "TOKEN",
    "token_type": "TOKEN_TYPE",
    "expires_in": 100,
    "refresh_token": "REFRESH_TOKEN"
  },
  "instance_name": "INSTANCE_NAME",
  "request_origin": "REQUEST_ORIGIN"
}