> For the complete documentation index, see [llms.txt](https://docs.catalyx.solutions/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.catalyx.solutions/catalyx-blockchain-manager/hyperledger-fabric/version-2.4/network-and-node-management/msp-and-partners.md).

# MSP and Partners

## What is an MSP?

While every entity on the network can have a digital certificate and a valid identity, they must have specific roles and permissions. The **Membership Service Provider (MSP)** provides information used for authenticating users in a particular network by mapping their identities to their roles.

An **organization** in an MSP is the collection of members grouped under the same identity. The MSP establishes the relationship between the member and the organization by linking the member's identity to the organization.

{% hint style="info" %}
It is a standard naming convention to name the MSP after the organization.
{% endhint %}

You can read more about the MSP in the [official Hyperledger Fabric documentation](https://hyperledger-fabric.readthedocs.io/en/release-2.2/membership/membership.html).

## How to Create an Organization's MSP?

Go to the **"Your MSP"** tab and click the **Create organization** button.

<figure><img src="/files/RpLmM8fllSn6OB1FESVh" alt=""><figcaption></figcaption></figure>

A side window will appear asking for parameters in five sections:

<figure><img src="/files/6Pj4IoxvF68gxkS2qO1A" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

#### Provide the MSP name and MSP ID

{% endstep %}

{% step %}

#### Add CA certificates

Add root CA certificates and intermediate CA certificates — these CAs will be accepted by the network for registering and enrolling signing identities. You can upload a CA certificate from your computer or select among the CAs in Catalyst Blockchain Manager.
{% endstep %}

{% step %}

#### Add TLS CA certificates

Add root TLS CA certificates and intermediate TLS CA certificates — these CAs are accepted by the network for registering and enrolling TLS certificates for identities.
{% endstep %}

{% step %}

#### Set admin identity

Set your MSP's admin identity. You can select an existing identity or generate a new one by providing its name and password. You can add other admins' certificates by uploading them.
{% endstep %}

{% step %}

#### Create TLS identity

The platform needs this identity to function within the network under your MSP. You can select an existing identity or create a new one.

After clicking **Next** in step 4, you can preview the details. If all details are correct, click **Submit**.
{% endstep %}
{% endstepper %}

{% hint style="danger" %}

* You must add all certificates of the full chain of trust for each intermediate CA you want to use for registering/enrolling identities.
* If you add intermediate CAs, use **only** intermediate CAs for registering/enrolling identities, not root CAs.
* You must add at least one root CA certificate to both the Root CA and TLS Root CA sections.
  {% endhint %}

{% hint style="info" %}
You can add only one MSP per organization.
{% endhint %}

The MSP will be visible under the **"Your MSPs"** tab. You can click the number of certificates to see full certificate details.

<figure><img src="/files/OvgedhOVuMSMQ753joqR" alt=""><figcaption></figcaption></figure>

**Available actions:**

* **Export** — Download the JSON file of the MSP (needed to add your organization to other organizations' partner lists)
* **Delete** the MSP

{% hint style="warning" %}
If the MSP is deleted, you cannot use ordering and peer nodes created within this MSP. To restore it, create a new MSP with the same name, ID, and certificates.
{% endhint %}

## How to Add Organization as a Partner?

For Organization 2 to join your network and become a partner:

{% stepper %}
{% step %}

#### Organization 2 creates its MSP and exports the JSON file

The JSON file is available through the **Export** button in the **Actions** column of the "Your MSPs" table.

<figure><img src="/files/KeIfPDyplnODeXQ7Jn7D" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Organization 2 shares the JSON file with Organization 1

{% endstep %}

{% step %}

#### Organization 1 adds Organization 2 as a partner

Click the **Add partner** button under the **"MSPs and Partners"** tab and provide the JSON file of Organization 2's MSP.

<figure><img src="/files/EDLc7Kz0aWoBEXieADMW" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Partners can be added one at a time.
{% endhint %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.catalyx.solutions/catalyx-blockchain-manager/hyperledger-fabric/version-2.4/network-and-node-management/msp-and-partners.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.