> For the complete documentation index, see [llms.txt](https://docs.artific.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.artific.nl/voor-beheerders/organisatie/gedeelde-connectors.md).

# Gedeelde connectors

Connectors die je één keer voor de hele organisatie registreert. Te vinden onder **Organisatiebeheer → Gedeelde connectors**.

## Waarom je een connector deelt

Een [connector](/voor-beheerders/assistenten/connectors.md) kun je aan één assistent toevoegen. Dat gaat prima bij één assistent, en is onhoudbaar bij tien: dezelfde server-URL, dezelfde inloggegevens en dezelfde afwegingen over welke acties zijn toegestaan, overal herhaald en na verloop van tijd uit elkaar gegroeid.

Een gedeelde connector registreer je hier één keer. Elke assistent of elk Toolbox-element in de organisatie kan hem daarna gebruiken met **Bestaande gebruiken**, zonder dat de beheerder daarvan ooit de inloggegevens in handen krijgt.

## Er een toevoegen

**Connector toevoegen** opent een catalogus met bekende diensten die je kunt doorzoeken en filteren op categorie. Kies je er een, dan wordt het grootste deel van het formulier alvast ingevuld. Met **Aangepaste connector toevoegen** richt je er zelf een in.

Het formulier is hetzelfde als bij een connector van een assistent: naam, server-URL, transport en authenticatie. Zie [Connectors](/voor-beheerders/assistenten/connectors.md) voor de details per veld.

Hier komt er één optie bij:

| Instelling                    | Wat het doet                                                    |
| ----------------------------- | --------------------------------------------------------------- |
| **Delen met suborganisaties** | Maakt de connector ook beschikbaar voor je dochterorganisaties. |

{% hint style="warning" %}
Delen met suborganisaties ligt vast zodra de connector is aangemaakt en kan daarna niet meer worden gewijzigd. Beslis het voordat je opslaat. Wil je het toch anders, maak dan een nieuwe connector aan.
{% endhint %}

**Verbinding testen** moet slagen voordat je kunt opslaan, en opnieuw na elke wijziging aan de verbinding zelf. Vanuit het testresultaat kun je meteen losse acties toestaan of blokkeren.

## Acties centraal regelen

**Acties beheren** bepaalt welke acties van de server beschikbaar zijn. Dit is de belangrijkste reden om een connector te delen: de keuze wordt één keer gemaakt, door jou, en elke assistent neemt hem over.

Acties die je hier blokkeert, zijn overal verborgen en kunnen niet door de beheerder van een assistent weer worden aangezet. Die ziet **Geblokkeerd door je organisatie** op de rij staan.

Begin met alles geblokkeerd behalve wat echt nodig is, zeker bij connectors die kunnen schrijven, verwijderen of versturen.

## Overgenomen connectors

Een connector met de aanduiding **Overgenomen** komt van een moederorganisatie. Je kunt hem gebruiken, maar niet bewerken, verwijderen of aanpassen welke acties zijn toegestaan. De moederorganisatie is eigenaar.

Een connector met de aanduiding **Gedeeld** is van jou en wordt naar beneden gedeeld.

## Een connector weghalen

**Verwijderen** haalt hem weg. Gebruiken assistenten of elementen hem nog, dan krijg je een waarschuwing en de optie **Ontkoppelen en verwijderen**, die ze loskoppelt en hun opgeslagen inloggegevens verwijdert.

Een connector die nog door een suborganisatie wordt gebruikt, kun je hier helemaal niet weghalen. Die organisaties moeten hem eerst ontkoppelen.

{% hint style="danger" %}
Een gedeelde connector weghalen breekt in één keer elke assistent die hem gebruikt. Controleer eerst wat ervan afhangt. De bevestiging vertelt je om hoeveel het gaat.
{% endhint %}
