> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/fr/configuration/overleaf-toolkit/external-url.md).

# URL externe

### fonctionnalité « Depuis une URL externe »

Pour activer la [« Depuis une URL externe »](https://www.overleaf.com/learn/how-to/How_to_upload_a_file_using_an_external_URL) fonctionnalité, la variable `ENABLED_LINKED_FILE_TYPES` doit inclure `url` type :

```
ENABLED_LINKED_FILE_TYPES=project_file,project_output_file,url
```

Cela étendra à la fois le *Ajouter des fichiers* menu ainsi que la *Insérer une figure* liste déroulante de la barre d’outils : la *Ajouter des fichiers* menu vous permet d’ajouter un fichier à votre projet à l’aide de son URL, tandis que la *Insérer une figure* liste déroulante vous permet d’insérer une image dans votre document directement depuis son URL.

#### Note de sécurité

Lorsque les utilisateurs ajoutent un lien vers un fichier externe dans leurs projets, le fichier est récupéré au nom du serveur sur lequel Overleaf est installé.

Si le serveur Overleaf est hébergé au sein d’un réseau privé qui contient également des serveurs HTTP internes (destinés uniquement à un usage interne), un utilisateur ayant accès à Overleaf pourrait potentiellement accéder aux données de ces services internes.

Pour éviter cela, les liens vers des fichiers externes ne doivent pas pointer vers des serveurs dont les adresses IP appartiennent à l’une des plages réseau restreintes. Il s’agit des suivantes :

* `127.0.0.0/8` (boucle locale)
* `169.254.0.0/16` (liaison locale)
* `10.0.0.0/8` (réseau privé)
* `172.16.0.0/12` (réseau privé)
* `192.168.0.0/16` (réseau privé)

De plus, la variable d’environnement suivante est introduite :

* `OVERLEAF_LINKED_URL_BLOCKED_NETWORKS`
  * Une liste de réseaux séparés par des espaces, au format CIDR, à partir desquels la récupération de ressources externes est interdite. En général, cela doit inclure le réseau interne de l’organisation.
    * Exemple : `OVERLEAF_LINKED_URL_BLOCKED_NETWORKS=123.123.0.0/16 124.124.124.0/24`

Cependant, dans de nombreuses organisations, les serveurs du réseau interne peuvent également héberger des données qui devraient être accessibles publiquement. Pour autoriser l’accès à des ressources spécifiques même si l’ensemble du réseau est bloqué, la variable d’environnement suivante est fournie :

* `OVERLEAF_LINKED_URL_ALLOWED_RESOURCES`
  * Une expression régulière définissant les ressources web autorisées à partir desquelles des fichiers externes peuvent être récupérés. Si une URL correspond à cette expression régulière, l’accès lui est accordé même si son réseau est par ailleurs bloqué.
    * Exemple : pour autoriser des URL comme `https://www.example.com/~john/pictures/frog.jpg` et `http://www.example.com/public/whatever/lit.bib`:

      `OVERLEAF_LINKED_URL_ALLOWED_RESOURCES=^https?://www\.example\.com/(?:~[^/]+|public)(?:/.*)?`
    * Exemple : pour refuser des URL comme `http://www.example.com/private/whatever/file`, tout en autorisant toutes les autres ressources ne se trouvant pas dans le `sous-arbre` :

      `OVERLEAF_LINKED_URL_ALLOWED_RESOURCES=^https?://www\.example\.com/(?!private)(?:.*)`<br>


---

# 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, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/fr/configuration/overleaf-toolkit/external-url.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.