A constellation is a secure area in which you can deploy your applications. You can take comfort in the notion that nothing from the public internet can access your resources unless you choose to allow it. A wormhole is the mechanism by which you allow traffic to enter your constellation from the Internet.
Creating a Wormhole
Creating a wormhole involves clicking the
Wormhole+ icon in the tool palette while on the logical
view of the constellation canvas. Upon clicking this, you will be presented a dialog like the
There will be two drop-down lists. The first, actor, will draw from a list of all actors
currently running in the constellation that are granted the
wasmcloud:httpserver capability that
are bound to an instance of the
HTTP Server - Wormhole provider (note there can be multiples of
these on a given canvas if they differ by link name). Clicking
Create Wormhole will create the
wormhole in the
open state. That is, it will be immediately accessible.
Removing and Closing Wormholes
If you delete (remove) a wormhole, it will be forever gone and you will lose the host name
associated with it. In the following screenshot from the wormhole details panel, you can see that
the host name is
Because of this, you will want to be very careful when deleting wormholes, especially if you have
already set up your own custom domain pointing to this host. If you want to stop inbound traffic to
your constellation, but you want to retain your claim to the host name, you can click the
Close Wormhole button. Once closed, for security reasons, a wormhole will reject incoming traffic,
pretending as though it doesn't exist to the outside Internet - you don't want people to be able
to tell the difference between closed and non-existent wormholes when probing for weaknesses.
If you want to require an authorization header to access your wormhole, then you can click the
require authentication option. Once you do this, Cosmonic will generate a bearer token on behalf
of this wormhole. You can then copy that token to a clipboard and supply it in the HTTP
Authorization header to obtain authentication.
Make sure to stay abreast of all of the Cosmonic news to be informed when new wormhole features, authentication modes, and content types become available.