Scribd
Upload
34 views5 pages

KB10097 - Bconnect Getting Started - Bconnect - Customers

Uploaded by

livin74897
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
34 views5 pages

KB10097 - Bconnect Getting Started - Bconnect - Customers

Uploaded by

livin74897
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 5

12/7/23, 3:51 PM KB10097 - bConnect Getting Started | bConnect | Customers

KB10097 - bConnect Getting Started

This article explains how to configure and use bConnect.

Activate the bConnect module


1. Go to Configuration > Interfaces

2. Activate bConnect and check the port.

By default port 443 is configured.

Export and Import of the Certificate (Root CA)


bConnect is a residual interface that communicates via an encrypted and certificate-protected communication
channel.

It is therefore necessary to export the automatically generated certificate of the baramundi certification authority
(root CA). This also signs the certificate bound to port 443 by default.

Tip: KB10136 Automated deployment of baramundi Root CA

Export
1. Go to bMC > Configuration > Mobile devices

2. Select bMD server and go to Certificate authority

3. Click on the right arrow for export and safe it.

https://feedback.baramundi.de/knowledge-base/article/kb10097-bconnect-getting-started 1/5
12/7/23, 3:51 PM KB10097 - bConnect Getting Started | bConnect | Customers

Import
1. Import the baramundi Root CA to the Trusted Root Certification Authorities so that the certificate chain is
complete.

Run a first test call of bConnect to check if the basic setup of the interface is
correct
1. Open your bConnect interface

Basic structure, please adapt:

https://<bmsserver.domain>(:<port>)/bConnect/Info.xml

Example

https://mma-srv-02-en.moma.test/bConnect/Info.xml

The Root Certificate is bound on the Server - FQDN.


In the Server SSL certificate, you can see the Common Name (CN) used.
In the test call with a Browser, the Server should be trusted.

https://feedback.baramundi.de/knowledge-base/article/kb10097-bconnect-getting-started 2/5
12/7/23, 3:51 PM KB10097 - bConnect Getting Started | bConnect | Customers

Types of Request = REST methods

GET The GET method allows you to request a resource from the server.

POST The POST method creates a new resource on the server.

PATCH The PATCH method changes the resource on the se

DELETE The DELETE method deletes the specified resource on the server.

If a parameter (for example, a specific client) should be used, it must be added to the call separated by
a question mark.

(e.g. https://bmsserver.customer.net/bConnect/v1.0/search.xml?type=endpoint&term=test)

What is a controller?

A controller accepts the request, processes it and returns a result.

Depending on what is to be queried, changed or deleted, the corresponding controller must be addressed.

Data format
There are two file formats available

XML and
JSON

Examples

GET
1. Show all endpoints in XML format

Basic structure, please adapt:

https://<bmsserver.domain>:<port>/bConnect/v1.0/Endpoints.xml

Example

https://mma-srv-02-en.moma.test/bConnect/v1.0/Endpoints.xml

2. Search for a specific endpoint in XML format

https://feedback.baramundi.de/knowledge-base/article/kb10097-bconnect-getting-started 3/5
12/7/23, 3:51 PM KB10097 - bConnect Getting Started | bConnect | Customers

Basic structure, please adapt:

https://<bmsserver.domain>:<port>/bConnect/v1.0/Search.xml?type=endpoint&term=<term>

Example

https://mma-srv-02-en.moma.test/bConnect/v1.0/Search.xml?type=endpoint&term=CL

Power Shell: Call


$creds = Get-Credential
$bserver = "mma.srv.02.en.moma.test"

$api = "https://$bserver/bConnect";

# info query
Invoke-RestMethod -Uri "$($api)/info.json" -Credential $creds -Method Get

# endpoint query

Invoke-RestMethod -Uri "$($api)/v1.0/Endpoints.json" -Credential $creds -Method Get

https://feedback.baramundi.de/knowledge-base/article/kb10097-bconnect-getting-started 4/5
12/7/23, 3:51 PM KB10097 - bConnect Getting Started | bConnect | Customers

https://feedback.baramundi.de/knowledge-base/article/kb10097-bconnect-getting-started 5/5

You might also like