> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/fr/configuration/overleaf-toolkit/external-url.md).

# URL externe

### fonction « From External URL »

Pour activer la [« From External URL »](https://www.overleaf.com/learn/how-to/How_to_upload_a_file_using_an_external_URL) fonction, 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 et le *Insérer une figure* menu déroulant dans la barre d’outils : le *Ajouter des fichiers* menu vous permet d’ajouter un fichier à votre projet à l’aide de son URL, tandis que le *Insérer une figure* menu déroulant vous permet d’insérer une image dans votre document directement à partir de son URL.

#### Remarque de sécurité

Lorsque des 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é à l’intérieur 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 de réseau restreintes. Il s’agit de :

* `127.0.0.0/8` (loopback)
* `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é)

En outre, 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, depuis lesquels la récupération de ressources externes est interdite. En général, elle 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 au sein du réseau interne peuvent également héberger des données qui devraient être accessibles publiquement. Pour permettre 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 qui ne se trouvent pas dans le `private` 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://overleaf-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.