s_('IrkerService|Send update messages to an irker server.')
end
end
defself.to_param
defself.to_param
...
@@ -42,33 +44,25 @@ module Integrations
...
@@ -42,33 +44,25 @@ module Integrations
end
end
deffields
deffields
recipients_docs_link=link_tos_('IrkerService|How to enter channels or users?'),Rails.application.routes.url_helpers.help_page_url('user/project/integrations/irker',anchor: 'enter-irker-recipients'),target: '_blank',rel: 'noopener noreferrer'
help: 'Recipients have to be specified with a full URI: '\
help: s_('IrkerService|Channels and users separated by whitespaces. %{recipients_docs_link}').html_safe%{recipients_docs_link: recipients_docs_link.html_safe}},
'irc[s]://irc.network.net[:port]/#channel. Special cases: if '\
' vulnerable to spamming IRC channels if it is hosted outside of a '\
s_('IrkerService|Send update messages to an irker server. Before you can use this, you need to set up the irker daemon. %{docs_link}').html_safe%{docs_link: docs_link.html_safe}
' firewall. Please make sure you run the daemon within a secured network '\
' to prevent abuse. For more details, read: http://www.catb.org/~esr/irker/security.html.'
@@ -695,16 +695,15 @@ Get Hangouts Chat service settings for a project.
...
@@ -695,16 +695,15 @@ Get Hangouts Chat service settings for a project.
GET /projects/:id/services/hangouts-chat
GET /projects/:id/services/hangouts-chat
```
```
## Irker (IRC gateway)
## irker (IRC gateway)
Send IRC messages, on update, to a list of recipients through an Irker gateway.
Send IRC messages, on update, to a list of recipients through an irker gateway.
### Create/Edit Irker (IRC gateway) service
For more information, see the [irker integration documentation](../user/project/integrations/irker.md).
Set Irker (IRC gateway) service for a project.
### Create/Edit irker (IRC gateway) service
NOTE:
Set irker (IRC gateway) service for a project.
Irker does NOT have built-in authentication, which makes it vulnerable to spamming IRC channels if it is hosted outside of a firewall. Please make sure you run the daemon within a secured network to prevent abuse. For more details, read [Security analysis of `irker`](http://www.catb.org/~esr/irker/security.html).
info:To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
info:To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
---
---
# Irker IRC Gateway **(FREE)**
# irker IRC Gateway **(FREE)**
GitLab provides a way to push update messages to an Irker server. When
GitLab provides a way to push update messages to an irker server. When
configured, pushes to a project trigger the service to send data directly
configured, pushes to a project trigger the service to send data directly
to the Irker server.
to the irker server.
See the [project homepage](https://gitlab.com/esr/irker) for further information.
See also the [irker integration API documentation](../../../api/services.md).
## Needed setup
For more information, see the [irker project homepage](https://gitlab.com/esr/irker).
You first need an Irker daemon. You can download the Irker code
## Set up an irker daemon
[from its repository](https://gitlab.com/esr/irker):
```shell
You need to set up an irker daemon. To do so:
git clone https://gitlab.com/esr/irker.git
```
Once you have downloaded the code, you can run the Python script named `irkerd`.
1. Download the irker code [from its repository](https://gitlab.com/esr/irker):
This script is the gateway script, it acts both as an IRC client, for sending
messages to an IRC server, and as a TCP server, for receiving messages
from the GitLab service.
If the Irker server runs on the same machine, you are done. If not, you
```shell
git clone https://gitlab.com/esr/irker.git
```
1. Run the Python script named `irkerd`. This is the gateway script.
It acts both as an IRC client, for sending messages to an IRC server,
and as a TCP server, for receiving messages from the GitLab service.
If the irker server runs on the same machine, you are done. If not, you
need to follow the first steps of the next section.
need to follow the first steps of the next section.
WARNING:
irker does **not** have built-in authentication, which makes it vulnerable to spamming IRC channels if
it is hosted outside of a firewall. To prevent abuse, make sure you run the daemon on a secured
network. For more details, read
[Security analysis of irker](http://www.catb.org/~esr/irker/security.html).
## Complete these steps in GitLab
## Complete these steps in GitLab
1. Navigate to the project you want to configure for notifications.
1. On the top bar, select **Menu > Projects** and find the project you want to
1. Navigate to the [Integrations page](overview.md#accessing-integrations)
configure for notifications.
1. Click "Irker".
1. Navigate to the [Integrations page](overview.md#accessing-integrations).
1. Select **irker (IRC gateway)**.
1. Ensure that the **Active** toggle is enabled.
1. Ensure that the **Active** toggle is enabled.
1. Enter the server host address where `irkerd` runs (defaults to `localhost`)
1. Optional. Under **Server host**, enter the server host address where `irkerd` runs. If empty,
in the `Server host` field on the Web page
it defaults to `localhost`.
1. Enter the server port of `irkerd` (e.g. defaults to 6659) in the
1. Optional. Under **Server port**, enter the server port of `irkerd`. If empty, it defaults to `6659`.
`Server port` field on the Web page.
1. Optional. Under **Default IRC URI**, enter the default IRC URI, in the format `irc[s]://domain.name`.
1. Optional: if `Default IRC URI` is set, it has to be in the format
It's prepended to every channel or user provided under **Recipients**, which is not a full URI.
`irc[s]://domain.name` and is prepended to each and every channel provided
1. Under **Recipients**, enter the users or channels to receive updates, separated by spaces
by the user which is not a full URI.
(for example, `#channel1 user1`). For more details, see [Enter irker recipients](#enter-irker-recipients).
1. Specify the recipients (e.g. #channel1, user1, etc.)
1. Optional. Under **Colorize messages**, select the checkbox. irker will highlight your messages.
1. Save or optionally click "Test Settings".
1. Select **Save changes** or optionally select **Test Settings**.
## Note on Irker recipients
## Enter irker recipients
Irker accepts channel names of the form `chan` and `#chan`, both for the
If you left the **Default IRC URI** field empty, enter recipients as a full URI:
`#chan` channel. If you want to send messages in query, you need to add
`irc[s]://irc.network.net[:port]/#channel`. If you entered a default IRC URI there, you can use just
`,isnick` after the channel name, in this form: `Aorimn,isnick`. In this latter
channel or user names.
case, `Aorimn` is treated as a nick and no more as a channel name.
To send messages:
Irker can also join password-protected channels. Users need to append
`?key=thesecretpassword` to the channel name. When using this feature remember to
- To a channel (for example, `#chan`), irker accepts channel names of the form `chan` and
**not** put the `#` sign in front of the channel name; failing to do so
`#chan`.
results in Irker joining a channel literally named `#chan?key=password` henceforth
- To a password-protected channel, append `?key=thesecretpassword` to the channel name,
leaking the channel key through the `/whois` IRC command (depending on IRC server
with the channel password instead of `thesecretpassword`. For example, `chan?key=hunter2`.
configuration). This is due to a long standing Irker bug.
Do **not** put the `#` sign in front of the channel name. If you do, irker tries to join a
channel named `#chan?key=password` and so it can leak the channel password through the
`/whois` IRC command. This is due to a long-standing irker bug.
- In a user query, add `,isnick` after the user name. For example, `UserSmith,isnick`.
