Skip to content

Commit 34144e4

Browse files
authored
Add security information to guidelines (#268)
1 parent b989584 commit 34144e4

File tree

1 file changed

+34
-8
lines changed

1 file changed

+34
-8
lines changed

doc/about/user-guidelines.md

Lines changed: 34 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -148,7 +148,32 @@ resources for interactive cloud computing.
148148

149149
## Security and privacy
150150

151-
### How does mybinder.org ensure user privacy?
151+
[mybinder.org](https://mybinder.org) allows users to execute arbitrary code, including some outgoing network traffic.
152+
Users can upload additional files from their computer, fetch files from remote machines and upload files to remote machines.
153+
154+
Providing a massively open public service like this also opens the opportunity for others to abuse our platform.
155+
We've taken care to avoid being used as [a link in an attack chain](https://en.wikipedia.org/wiki/Kill_chain#Cyber), or otherwise being abused, and haveput several safeguards in place.
156+
This section describes several aspects of using mybinder.org in a secure fashion.
157+
158+
:::{admonition} If you've found a security problem
159+
Please see [](security:report).
160+
:::
161+
162+
### An overview of Binder's security
163+
164+
Below is a short overview of major security efforts.
165+
166+
1. We limit outgoing bandwidth per-session (`~1mbit`) to protect against being used as a DDoS vector.
167+
2. We limit launches originating from most cloud providers to prevent being used automatically in various attacks.
168+
3. We have anti-cryptomining safeguards that automatically detect and kill processes associated with mining.
169+
4. We ban malicious repositories from being launched when they are brought to our attention.
170+
5. We impose general resource limits (inactivity culling timeouts, memory / CPU limits, max concurrent launches, etc) to make us a less tempting target for these attacks.
171+
6. We do not offer persistent storage of any sort, to protect us from becoming a host for malware.
172+
173+
We're a volunteer run open infrastructure project, and welcome more engagement on how we can be better good citizens of the internet.
174+
If you've discovered a security problem on [mybinder.org](https://mybinder.org), please see [](security:report).
175+
176+
### How we ensure user privacy
152177

153178
We take user privacy very seriously! Because Binder runs as a public,
154179
free service, we don't require any kind of log-in that would let us
@@ -157,12 +182,12 @@ reproduced, classes taught - in short, everything that happens in a
157182
Binder session - is destroyed when the user logs off or becomes inactive
158183
for more than a few minutes.
159184

160-
Here are the pieces of information we do keep: We run google analytics
161-
with anonymized IPs and no cookies, which gives us just enough information
162-
to know how Binder is being used, and but won't be able to identify users.
163-
We also retain logs of IP addresses for 30 days, which is used solely in
164-
the case of detecting abuse of the service. If you have suggestions for
165-
how we can ensure the privacy of our data and users, we'd love to hear it!
185+
Here are the pieces of information we do keep:
186+
187+
- We run google analytics with anonymized IPs and no cookies, which gives us just enough information to know how Binder is being used, and but won't be able to identify users.
188+
- We retain logs of IP addresses for 30 days, which is used solely in the case of detecting abuse of the service.
189+
190+
If you have suggestions for how we can ensure the privacy of our data and users, we'd love to hear it!
166191

167192
### How secure is mybinder.org?
168193

@@ -181,7 +206,8 @@ call from a Jupyter Notebook).
181206
If you require private information within your
182207
Binder instance, consider [deploying a BinderHub for your group](https://binderhub.readthedocs.io/en/latest/).
183208

184-
### Where can I report a security issue?
209+
(security:report)=
210+
### Report a security issue
185211

186212
If you find a security vulnerability in with `mybinder.org`, please report
187213

0 commit comments

Comments
 (0)