REL-ID for MobileREL-ID APIsREL-ID for Web
Guides
Start typing to searchā€¦

Discover Available services

šŸŒ Service Discovery APIs ā€“ REL-ID SDK Documentation

This document describes the following service discovery APIs available in the REL-ID SDK:

  • getAllServices()
  • getServiceByServiceName()
  • getServiceByTargetCoordinate()

šŸ“˜ Overview

These APIs allow apps to discover services (e.g., intranet apps, internal APIs) that the current user is authorized to access via secure tunnels established by the SDK.

šŸ” getAllServices()

šŸ§­ Purpose

Retrieve a list of all services available to the user based on REL-ID policy.

šŸ“¤ Request

No parameters required.

šŸ“¦ Response

Each service entry typically includes:

FieldTypeDescription
serviceIdstringUnique ID of the service
namestringHuman-readable service name
hoststringHostname or IP
portintegerPort number
descriptionstringDescription or notes (optional)

āœ… Sample Code

React Native
const services = await RdnaClient.getAllServices();
console.log(services);
Flutter
var services = await rdna.getAllServices();
print(services);
Cordova
com.uniken.rdnaplugin.RdnaClient.getAllServices(function(services) {
  console.log(services);
});
Native Android
RdnaClient.getInstance().getAllServices(new RdnaCallback() {
  @Override
  public void onSuccess(Object result) {
    Log.d("Services", result.toString());
  }

  @Override
  public void onError(RdnaError error) {
    Log.e("Error", error.getMessage());
  }
});
Native iOS
RdnaClient.shared.getAllServices { result, error in
    if let services = result {
        print(services)
    } else if let error = error {
        print("Error: \(error.localizedDescription)")
    }
}

šŸ”Ž getServiceByServiceName()

šŸ§­ Purpose

Fetch service info using its registered name.

šŸ“¤ Request

{
  "serviceName": "internalAppService"
}
FieldTypeDescription
serviceNamestringName assigned on REL-ID server

āœ… Sample Code

React Native
const service = await RdnaClient.getServiceByServiceName("internalAppService");
console.log(service);
Flutter
var service = await rdna.getServiceByServiceName("internalAppService");
print(service);
Cordova
com.uniken.rdnaplugin.RdnaClient.getServiceByServiceName("internalAppService", function(service) {
  console.log(service);
});
Native Android
RdnaClient.getInstance().getServiceByServiceName("internalAppService", new RdnaCallback() {
  @Override
  public void onSuccess(Object result) {
    Log.d("Service", result.toString());
  }

  @Override
  public void onError(RdnaError error) {
    Log.e("Error", error.getMessage());
  }
});
Native iOS
RdnaClient.shared.getServiceByServiceName("internalAppService") { result, error in
    if let service = result {
        print(service)
    } else if let error = error {
        print("Error: \(error.localizedDescription)")
    }
}

šŸŽÆ getServiceByTargetCoordinate()

šŸ§­ Purpose

Look up a service by host and port.

šŸ“¤ Request

{
  "host": "10.0.0.1",
  "port": 443
}
FieldTypeDescription
hoststringTarget IP or domain
portintegerPort to connect

āœ… Sample Code

React Native
const service = await RdnaClient.getServiceByTargetCoordinate("10.0.0.1", 443);
console.log(service);
Flutter
var service = await rdna.getServiceByTargetCoordinate("10.0.0.1", 443);
print(service);
Cordova
com.uniken.rdnaplugin.RdnaClient.getServiceByTargetCoordinate("10.0.0.1", 443, function(service) {
  console.log(service);
});
Native Android
RdnaClient.getInstance().getServiceByTargetCoordinate("10.0.0.1", 443, new RdnaCallback() {
  @Override
  public void onSuccess(Object result) {
    Log.d("Service", result.toString());
  }

  @Override
  public void onError(RdnaError error) {
    Log.e("Error", error.getMessage());
  }
});
Native iOS
RdnaClient.shared.getServiceByTargetCoordinate(host: "10.0.0.1", port: 443) { result, error in
    if let service = result {
        print(service)
    } else if let error = error {
        print("Error: \(error.localizedDescription)")
    }
}

ā— Error Codes

CodeDescriptionResolution
404Service not foundCheck input or service policy
401Unauthorized or session expiredTrigger login or refresh token
500Internal server errorRetry or report issue

šŸ“Ž Use these APIs to dynamically discover services and build policy-based access UIs in your app.

Updated 9 months ago