Network proxies in Oda

DataMind Oda can reach the internet through an HTTP proxy. It reads the proxy variables your computer sets for programs and uses them for its own network requests. This page explains where those values come from, what always goes direct, and what happens when a value cannot be used.

Where Oda gets its proxy

What goes through the proxy

What stays direct

Questions, answered

Why does my browser use a proxy while Oda does not?

A browser follows the proxy settings of your operating system. A program like Oda does not read those; it reads the proxy variables your computer sets for programs instead. Set the value there, or save it in Oda's settings, and start Oda again.

Do I have to restart Oda after I change a proxy setting?

Yes. Oda reads the values once, when it starts, so a change applies from the next start. Removing a value works the same way.

Does traffic to my own computer go through the proxy?

No. localhost, 127.0.0.1, ::1 and 0.0.0.0 always go direct, so local apps never loop through the proxy, even while everything else uses it.

How do I keep other addresses out of the proxy?

Add them to the list of addresses to leave alone, in the same place where the proxy is set. An entry covers that address and every name under it. A leading dot or *. is accepted, and you can include a port. A single * leaves every request direct; address ranges such as 10.0.0.0/8 are not supported.

Are SOCKS proxies supported?

No. Only http:// and https:// proxy addresses are supported. A SOCKS address is noted once when Oda starts and skipped, and the requests it was meant for go direct.

What happens when Oda cannot use a proxy value?

If a value cannot be read, or names something Oda does not support such as a SOCKS or PAC address, it is noted once and skipped; the requests it was meant for go direct. A skipped value is never replaced by a different proxy, and your other values keep working as you set them. The note names which setting has the problem, never the value.

Can my proxy address include a user name and password?

Yes. Put the credentials in the address itself, before the host. Oda never prints the address back, so a password inside it does not appear in its notes. Keep in mind that the address is part of your environment, that the programs Oda runs can see it, and that it can end up in output that is kept. Prefer a proxy entry point that needs no password where one is available.

Do the commands and programs Oda runs use the proxy?

Yes. The values reach the programs Oda starts, so commands and helper tools that follow the environment use the same proxy. A value you set keeps the spelling you wrote; a kind you did not set carries the value Oda resolved; the leave-alone list always applies. A value Oda cannot use does not stop a program from starting. Command execution covers what each command receives.

Does Oda change my computer's proxy settings?

No. Oda applies the values to its own work and changes nothing on your computer. The route is put in place before its parts load and fully restored when it goes away, so a run that turns proxying off goes direct until it ends, and then your settings return.

Our proxy inspects secure traffic. Is anything else needed?

Yes. The proxy's certificate must be added to the list of extra trusted certificates, and that list is read only when a program starts. Set it up before you start Oda; anything added later applies at the next start.