post__register

POST /register

Register Bridge Node

This endpoint allows bridge nodes to register themselves with the platform without requiring traditional authentication. Instead, it uses RSA signature verification to ensure the request comes from an authorized organization key.

Key Features:

Cryptographic signature verification using RSA keys
Automatic node-key association upon successful registration
Support for multiple cloud providers (AWS, GCS, Azure, S3-compatible)
Node status and region tracking
Version information capture for compatibility monitoring

Authentication:

No traditional authentication required
Uses RSA signature verification for security
Signature must be generated using a valid organization private key
Timestamp validation prevents replay attacks

Supported Providers:

S3: AWS S3 and S3-compatible services
GCS: Google Cloud Storage
AZURE: Azure Blob Storage

Validation:

All required fields must be present
Provider type must be valid
Signature must be cryptographically valid
Timestamp must be recent to prevent replay attacks

TypeScript Client Library

public nodeRegister = async (data: RegisterRequest): Promise<RegisterResponse> => {
  return this.makeRequest<RegisterResponse>('register', 'POST', data);
};

Code Samples

# You can also use wget
curl -X POST https://backend.flashback.tech/register \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "provider": "S3",
    "ip": "192.168.1.100",
    "status": "active",
    "region": "us-east-1",
    "version": "1.0.0",
    "timestamp": "2024-01-15T10:30:00.000Z",
    "signature": "base64-encoded-signature",
    "id_org": "org-123e4567-e89b-12d3-a456-426614174000"
  }'

POST https://backend.flashback.tech/register HTTP/1.1
Host: localhost:3000
Content-Type: application/json
Accept: application/json

{
  "provider": "S3",
  "ip": "192.168.1.100",
  "status": "active",
  "region": "us-east-1",
  "version": "1.0.0",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "signature": "base64-encoded-signature",
  "id_org": "org-123e4567-e89b-12d3-a456-426614174000"
}

const inputBody = {
  "provider": "S3",
  "ip": "192.168.1.100",
  "status": "active",
  "region": "us-east-1",
  "version": "1.0.0",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "signature": "base64-encoded-signature",
  "id_org": "org-123e4567-e89b-12d3-a456-426614174000"
};

const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json'
};

fetch('https://backend.flashback.tech/register',
{
  method: 'POST',
  body: JSON.stringify(inputBody),
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/json',
  'Accept' => 'application/json'
}

body = {
  'provider' => 'S3',
  'ip' => '192.168.1.100',
  'status' => 'active',
  'region' => 'us-east-1',
  'version' => '1.0.0',
  'timestamp' => '2024-01-15T10:30:00.000Z',
  'signature' => 'base64-encoded-signature',
  'id_org' => 'org-123e4567-e89b-12d3-a456-426614174000'
}

result = RestClient.post 'https://backend.flashback.tech/register',
  body.to_json, headers: headers

p JSON.parse(result)

import requests
import json

headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

body = {
  'provider': 'S3',
  'ip': '192.168.1.100',
  'status': 'active',
  'region': 'us-east-1',
  'version': '1.0.0',
  'timestamp': '2024-01-15T10:30:00.000Z',
  'signature': 'base64-encoded-signature',
  'id_org': 'org-123e4567-e89b-12d3-a456-426614174000'
}

r = requests.post('https://backend.flashback.tech/register',
                  headers=headers,
                  data=json.dumps(body))

print(r.json())

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'application/json',
    'Accept' => 'application/json',
);

$body = array(
    'provider' => 'S3',
    'ip' => '192.168.1.100',
    'status' => 'active',
    'region' => 'us-east-1',
    'version' => '1.0.0',
    'timestamp' => '2024-01-15T10:30:00.000Z',
    'signature' => 'base64-encoded-signature',
    'id_org' => 'org-123e4567-e89b-12d3-a456-426614174000'
);

$client = new \GuzzleHttp\Client();

try {
    $response = $client->request('POST','https://backend.flashback.tech/register', array(
        'headers' => $headers,
        'json' => $body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

URL obj = new URL("https://backend.flashback.tech/register");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
con.setRequestProperty("Content-Type", "application/json");
con.setRequestProperty("Accept", "application/json");

String jsonInputString = "{\"provider\":\"S3\",\"ip\":\"192.168.1.100\",\"status\":\"active\",\"region\":\"us-east-1\",\"version\":\"1.0.0\",\"timestamp\":\"2024-01-15T10:30:00.000Z\",\"signature\":\"base64-encoded-signature\",\"id_org\":\"org-123e4567-e89b-12d3-a456-426614174000\"}";

con.setDoOutput(true);
try(OutputStream os = con.getOutputStream()) {
    byte[] input = jsonInputString.getBytes("utf-8");
    os.write(input, 0, input.length);
}

int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
       "encoding/json"
)

func main() {
    body := map[string]interface{}{
        "provider": "S3",
        "ip": "192.168.1.100",
        "status": "active",
        "region": "us-east-1",
        "version": "1.0.0",
        "timestamp": "2024-01-15T10:30:00.000Z",
        "signature": "base64-encoded-signature",
        "id_org": "org-123e4567-e89b-12d3-a456-426614174000",
    }

    jsonData, _ := json.Marshal(body)

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
    }

    data := bytes.NewBuffer(jsonData)
    req, err := http.NewRequest("POST", "https://backend.flashback.tech/register", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Body parameter

{
  "provider": "S3",
  "ip": "192.168.1.100",
  "status": "active",
  "region": "us-east-1",
  "version": "1.0.0",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "signature": "base64-encoded-signature",
  "id_org": "org-123e4567-e89b-12d3-a456-426614174000"
}

Parameters

Name

Type

Required

Description

body

object

true

Node registration data

» provider

body

string

true

Cloud storage provider type

» ip

body

string

true

Node IP address (used as unique identifier)

» status

body

string

true

Node status (e.g., active, inactive)

» region

body

string

true

Geographic region of the node

» version

body

string

true

Node software version

» timestamp

body

string

true

Request timestamp for signature verification

» signature

body

string

true

RSA signature of the request data

» id_org

body

string

false

Organization ID (optional)

Enumerated Values

Parameter

Value

» provider

GCS

» provider

AZURE

Example responses

200 Response

{
  "success": true,
  "message": "Registration successful"
}

400 Response

{
  "success": false,
  "message": "Missing required fields"
}

Responses

Status

Meaning

Description

Schema

200

Node registered successfully

Inline

400

Bad Request

Validation error or invalid signature

Inline

500

Internal Server Error

Registration failed

Inline

Response Schema

Status Code 200

Name

Type

Required

Restrictions

Description

» success

boolean

false

none

Operation success status

» message

string

false

none

Success message

Status Code 400

Name

Type

Required

Restrictions

Description

» success

boolean

false

none

Operation success status

» message

string

false

none

Error message describing the validation issue

Status Code 500

Name

Type

Required

Restrictions

Description

» success

boolean

false

none

Operation success status

» message

string

false

none

Error message describing the internal error

This operation does not require authentication as it uses cryptographic signature verification for security.

PreviousStorage Bridge Node Registration Nextpost__unregister

Last updated 1 month ago

Was this helpful?