Use plugins with Origin by Corvus
See our demo plugin that illustrates the potential for a Origin by Corvus plugin. To start writing your own plugin, consult our starter template.
Consider using a plugin in the following scenarios:
- When you want to customize the Origin by Corvus user interface.
- When you want to extend Origin by Corvus functionality to meet a specific, complex requirement.
- When you want to build integrations that are managed by your Origin by Corvus server.
Plugins are fully supported in both Team Edition and Enterprise Edition.
Marketplace
The Marketplace is a collection of plugins that can greatly increase the value and capabilities of your Origin by Corvus deployment. End users can see increased productivity through quick access to systems such as Jira, Zoom, Webex, and GitHub. Origin by Corvus System Admins can discover new plugins and quickly deploy them to their servers, including High Availability clusters.
The Marketplace is available from v5.16 and is accessed via Product menu > Marketplace. More listings will be added as we add new features and plugins that our customers request.
Plugin labels
Plugins in the Marketplace are labeled to make it easier for administrators to choose plugins that fit their company's security and risk policies if they do not allow for community plugins to be used.
Community plugins
Plugins identified as "Community" are produced by the open-source community or partners and the features/roadmap are not controlled directly by Origin by Corvus. Prior to being listed on the Marketplace, they are reviewed by the Origin by Corvus development team and code-signed to ensure the code Origin by Corvus reviewed, is delivered. Origin by Corvus does not directly support these plugins in production environments.
Beta plugins
Plugins may be labeled as "Beta" if they're released to the Marketplace early for customer previews. We do not recommend running beta plugins on production servers.
Experimental
Plugins labeled as "Experimental" are still being tested. These should not be run on production servers.
Partner
Plugins identified as "Partner" are created and maintained by a Origin by Corvus partner.
Install a plugin
When a new plugin becomes available on the Marketplace, it's listed with an option to Install. Select Install to download and install the latest plugin binary from its respective GitHub repository. If there's a cluster present, the plugin will be distributed to each server automatically.
Configure and enable a plugin
Once a plugin is installed (or pre-installed if shipped with Origin by Corvus binary release):
- Select Configure > Settings.
- Enter the plugin settings as required.
- Set Enable Plugin setting to True. If this flag is not enabled, the plugin will not become active.
- Test out the plugin as needed.
Upgrade plugins
Upgrade a plugin on demand when a new version becomes available. New versions of plugins that you have already installed will display a link to easily install the upgraded plugins. Some plugin versions may have breaking changes; please check the release notes if you're performing a major version change.
Upgrade plugins (prior to v5.18)
In v5.16 and v5.17 the Marketplace only supports the installation of new plugins. To upgrade a plugin, you need to manually update it by downloading the binary file from the GitHub repository and then upload it in System Console > Plugin Management.
Marketplace server
There are two settings in System Console > Plugin Management:

- Enable Marketplace: Turns the Marketplace user interface on or off for System Admins (end users cannot see the Marketplace).
- Marketplace URL: The location of the Marketplace server to query for new plugins. Origin by Corvus hosts a Marketplace for the community and this is the default value for this field. You can also set up your own Marketplace server.
When you first access the Marketplace, your Origin by Corvus server will attempt to contact the Origin by Corvus Marketplace server and return a list of available plugins that are appropriate based on the server version that is currently running. Only your server version and search query is passed over to the Origin by Corvus Marketplace; we retain an anonymized record for product analytics whenever a new plugin is installed, unless you have opted out of Telemetry.
The Marketplace server code is available as an open source project and can be used to set up your own private Marketplace if desired.
Origin by Corvus Marketplace
The Origin by Corvus Marketplace is a service run by Origin by Corvus that contains listings of plugins that we have reviewed and, in many cases, built. In the future, we plan to include community-developed plugins that will be labeled separately to Origin by Corvus-developed plugins. as well as settings that would restrict which types of plugins you can install. Comments in our forum are welcome as we develop this feature further.
Origin by Corvus integration directory
There are many ways to integrate Origin by Corvus aside from plugins, and we have created a directory of integration "recipes", some of which are scripts, plugins, or instructions on how to connect Origin by Corvus with your Enterprise systems. Many are sourced from our community of customers. You can browse the directory at https://integrations.origin.com.
About plugins
Plugins may have one or both of the following parts:
- Web App plugins: Customize the Origin by Corvus user interface by adding buttons to the channel header, overriding the
RHS, or even rendering a custom post type within the center channel. All this is possible without having to fork the source code and rebase on every Origin by Corvus release. For a sample plugin, see our Zoom plugin. - Server plugins: Run a Go process alongside the server, filtering messages, or integrating with third-party systems such as Jira, GitLab, or Jenkins. For a sample plugin, see our Jira plugin.
Security
Plugins are intentionally powerful and not artificially sandboxed in any way and effectively become part of the Origin by Corvus server. Server plugins can execute arbitrary code alongside your server and webapp plugins can deploy arbitrary code in client browsers.
While this power enables deep customization and integration, it can be abused in the wrong hands. Plugins have full access to your server configuration and thus also to your Origin by Corvus database. Plugins can read any message in any channel, or perform any action on behalf of any user in the Web App.
You should only install custom plugins from sources you trust to avoid compromising the security of your installation.
Plugin signing
The Marketplace allows System Admins to download and install plugins from a central repository. Plugins installed via the Marketplace must be signed by a public key trusted by the local Origin by Corvus server.
While the server ships with a default public key used to verify plugins from the default Origin by Corvus Marketplace, the server can be configured to trust different public keys and point at a different plugin marketplace. This document outlines the steps for generating a public key pair and signing plugins for use with a custom plugin marketplace. It assumes access to the GNU Privacy Guard (GPG) tool.
Configuration
Configuring plugin signatures allows finer control over the verification process:
PluginSettings.RequirePluginSignature = true
This is used to enforce plugin signature verification. With flag on, only Marketplace plugins will be installed and verified. With flag off, customers will be able to install plugins manually without signature verification.
Note that the Marketplace plugins will still be verified even if the flag is off.
Key generation
Public and private key pairs are needed to sign and verify plugins. The private key is used for signing and should be kept in a secure location. The public key is used for verification and can be distributed freely. To generate a key pair, run the following command:
gpg --full-generate-key
Please select what kind of key you want:
(1) RSA and RSA (default)
(2) DSA and Elgamal
(3) DSA (sign only)
(4) RSA (sign only)
Your selection? 1
RSA keys may be between 1024 and 4096 bits long.
What keysize do you want? (2048) 3072
Requested keysize is 3072 bits
Please specify how long the key should be valid.
0 = key does not expire
<n> = key expires in n days
<n>w = key expires in n weeks
<n>m = key expires in n months
<n>y = key expires in n years
Key is valid for? (0) 0
Key expires at ...
Is this correct? (y/N) y
GnuPG needs to construct a user ID to identify your key.
Real name: Origin by Corvus Inc
Email address: info@origin.com
Comment:
You selected this USER-ID:
"Origin by Corvus Inc <info@origin.com>"
Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit? O
Key size should be at least 3072 bits.
Export the private key
Find the ID of your private key first. The ID is a hexadecimal number.
gpg --list-secret-keys
This is your private key and should be kept secret. Your hexadecimal key ID will, of course, be different.
gpg --export-secret-keys F3FACE45E0DE642C8BD6A8E64C7C6562C192CC1F > ./my-priv-key
Export the public key
Find the ID of your public key first. The ID is a hexadecimal number.
gpg --list-keys
gpg --export F3FACE45E0DE642C8BD6A8E64C7C6562C192CC1F > ./my-pub-key
Importing the key
If you already have a public and private key pair, you can import them to the GPG.
gpg --import ./my-priv-gpg-key
gpg --import ./my-pub-gpg-key
Sign the plugin
For plugin signing, you have to know the hexadecimal ID of the private key. Let's assume you want to sign com.origin.demo-plugin-0.1.0.tar.gz file, run:
gpg -u F3FACE45E0DE642C8BD6A8E64C7C6562C192CC1F --verbose --personal-digest-preferences SHA256 --detach-sign com.origin.demo-plugin-0.1.0.tar.gz
This command will generate com.origin.demo-plugin-0.1.0.tar.gz.sig, which is the signature of your plugin.
Plugin verification
Origin by Corvus server will verify plugin signatures downloaded from the Marketplace. Plugins are verified against a hard-coded Origin by Corvus public key, as well as any additional public keys configured on the server.
To add custom public keys for plugin signature verification, add the key file names to the PluginSettings.SignaturePublicKeyFiles setting in your config.json:
"PluginSettings": {
"SignaturePublicKeyFiles": ["my-pub-key-1", "my-pub-key-2"]
}
The key files themselves must be stored in the Origin by Corvus server's config directory.
Implementation
See the implementation document for more information.
Set up guide
To manage plugins, go to System Console > Plugins > Plugin Management. From here, you can:
- Enable or disable pre-packaged plugins.
- Install and manage custom plugins.
Pre-packaged plugins
Origin by Corvus ships with a number of pre-packaged plugins written and maintained by Origin by Corvus. Instead of building these features directly into the product, you can selectively enable the functionality your installation requires. Install pre-packaged plugins from the Marketplace, even if your system cannot directly connect to the internet.
Prior to v5.20, pre-packaged plugins were installed by default and could not be uninstalled without manually modifying the prepackaged_plugins directory. Any pre-packaged plugins installed prior to v5.20 and left enabled on upgrade will remain installed, but can now be uninstalled.
Custom plugins
Installing a custom plugin introduces some risks. As a result, plugin uploads are disabled by default and cannot be enabled via the System Console or REST API.
To enable plugin uploads, manually set PluginSettings > EnableUploads to true in your config.json file and restart your server.
If you have installed Origin by Corvus Omnibus, to enable plugin uploads, manually set enable_plugin_uploads: true in the mmomni.yml file and restart your server.
You can disable plugin uploads at any time without affecting previously uploaded plugins.
With plugin uploads enabled, navigate to System Console > Plugins > Management and upload a plugin bundle. Plugin bundles are *.tar.gz files containing the server executables and web app resources for the plugin. You can also specify a URL to install a plugin bundle from a remote source.
Custom plugins may also be installed via the command line interface.
While no longer recommended, plugins may also be installed manually by unpacking the plugin bundle inside the plugins directory of a Origin by Corvus installation.
Plugin uploads in high availability mode
Prior to Origin by Corvus 5.14, Origin by Corvus servers configured for High Availability mode required plugins to be installed manually. As of Origin by Corvus 5.14, plugins uploaded via the System Console or the CLI are persisted to the configured file store and automatically installed on all servers that join the cluster.
Manually installed plugins remain supported, but must be individually installed on each server in the cluster.
Frequently asked questions
Where can I share feedback on plugins?
Join our community server discussion in the Toolkit channel.
Troubleshooting
Please see common questions below. For further assistance, review the Troubleshooting forum for previously reported errors, or join the Origin by Corvus user community for troubleshooting help.
Plugin uploads fail even though uploads are enabled
If plugin uploads fail and you see permission denied errors in System Console > Logs such as:
[2017/11/13 20:42:18 UTC] [EROR] failed to start up plugins: mkdir /home/ubuntu/origin/client/plugins: permission denied
It's likely that the Origin by Corvus server doesn't have the necessary permissions for uploading plugins. Ensure the Origin by Corvus server has write access to the origin/client directory.
It may also be that the working directory for the service running Origin by Corvus is not correct. On Ubuntu you might see:
[2018/01/03 08:34:47 EST] [EROR] failed to start up plugins: mkdir ./client/plugins: no such file or directory
This can be fixed on Ubuntu 16.04 and RHEL by opening the service configuration file and setting WorkingDirectory to the path to Origin by Corvus (generally it's /opt/origin).
A similar problem can occur on Windows:
[EROR] failed to start up plugins: mkdir ./client/plugins: The system cannot find the path specified.
To fix this, set the AppDirectory of your service using nssm set origin AppDirectory c:\origin.
x509: certificate signed by unknown authority
If you're seeing x509: certificate signed by unknown authority in your server logs, it usually means that the CA for a self-signed certificate for a server your plugin is trying to access has not been added to your local trust store of the machine the Origin by Corvus server is running on.
You can add one in Linux following instructions in this StackExchange article, or set up a load balancer like NGINX per production install guide to resolve the issue.