BlueSpice Helpdesk - Recent changes [en]

Pagedraft:Reference/Swiki

Margit.link-rodrigue — Wed, 12 Aug 2026 09:20:52 GMT

Pagedraft:Reference/Spreadsheets

Margit.link-rodrigue — Wed, 12 Aug 2026 09:16:16 GMT

Pagedraft:Reference/SpreadsheetFileReader

Margit.link-rodrigue — Wed, 12 Aug 2026 09:15:13 GMT

Pagedraft:Reference/SimpleCharts

Margit.link-rodrigue — Wed, 12 Aug 2026 09:08:47 GMT

Pagedraft:BlueSpice 6

Margit.link-rodrigue — Wed, 12 Aug 2026 08:41:30 GMT

Template:BSExtensionInfo

Margit.link-rodrigue — Wed, 12 Aug 2026 07:05:02 GMT

← Older revision		Revision as of 07:05, 12 August 2026
(3 intermediate revisions by the same user not shown)
Line 2:		Line 2:
	Edit the page to see the template text.</noinclude><includeonly>{{#default_form:BSExtensionInfoForm}}		Edit the page to see the template text.</noinclude><includeonly>{{#default_form:BSExtensionInfoForm}}
	<i class="bi bi-arrow-right-circle"></i> [[:Category:Extension\|all extensions]]		<i class="bi bi-arrow-right-circle"></i> [[:Category:Extension\|all extensions]]
	~~{{#set:BSExtensionInfoRemoved={{{removed\|no}}} }}~~
	~~{{#ifeq:{{#show:{{FULLPAGENAME}}\|?BSExtensionInfoRemoved}}\|Yes\|~~
	~~{{Textbox\|boxtype=warning\|header=Not included\|text=This extension is bundled until [[en4:Main Page\|BlueSpice 4]]\|icon=yes}}~~
	}}
	{\| class="extension-infobox fullwidth"		{\| class="extension-infobox fullwidth"
	\|-		\|-
Line 11:		Line 7:
	\|-		\|-
	! Description:		! Description:
	~~\| colspan="3"~~ \| {{#set: BSExtensionInfoDescription={{#dpl: title=AutoDoc:{{PAGENAME}}\|include=#DescriptionMsg}}}} {{#dpl: title=AutoDoc:{{PAGENAME}}\|include=#DescriptionMsg}}		\| {{#set: BSExtensionInfoDescription={{#dpl: title=AutoDoc:{{PAGENAME}}\|include=#DescriptionMsg}}}} {{#dpl: title=AutoDoc:{{PAGENAME}}\|include=#DescriptionMsg}}
			! State:
			\| [[BSExtensionInfoStatus::{{{status\|}}}]]<!--
	\|-		\|-
	~~! State:~~
	~~\| [[BSExtensionInfoStatus::{{{status\|}}}]]~~
	! Dependency:		! Dependency:
	\| {{#arraymap:{{{compatible\|}}}\|,\|@@\|[[BSExtensionInfoCompatible::@@]]}}		\| {{#arraymap:{{{compatible\|}}}\|,\|@@\|[[BSExtensionInfoCompatible::@@]]}} -->
	\|-		\|-
	! Developer:		! Developer:

MediaWiki:Hf-nsfooter-Manual

Margit.link-rodrigue — Tue, 11 Aug 2026 07:04:06 GMT

← Older revision		Revision as of 07:04, 11 August 2026
Line 1:		Line 1:
	{{#ifeq:{{NAMESPACE}}\|Manual\|{{#ifeq:{{~~BASEPAGENAME~~}}\|~~Extension~~\|{{Messagebox\|boxtype=neutral\|icon=yes\|Note text=[[Reference:{{#titleparts: {{FULLPAGENAME}}\|1\|2}}\|Technical Reference: {{#titleparts: {{FULLPAGENAME}}\|1\|2}}]]\|bgcolor=#f1f3f9}}\|}}		{{#ifeq:{{NAMESPACE}}\|Manual\|{{#ifeq:{{SUBPAGENAME}}\|{{#explode:{{PAGENAME}}\|/\|1}}\|{{Messagebox\|boxtype=neutral\|icon=yes\|Note text=[[Reference:{{#titleparts: {{FULLPAGENAME}}\|1\|2}}\|Technical Reference: {{#titleparts: {{FULLPAGENAME}}\|1\|2}}]]\|bgcolor=#f1f3f9}}\|}}
	\|}}		\|}}


	{{Hf-nsfooter-content}}		{{Hf-nsfooter-content}}

Pagedraft:BlueSpice 6

Margit.link-rodrigue — Mon, 10 Aug 2026 15:30:02 GMT

Setup:Software Bill of Materials (SBOM)

Rvogel1 — Mon, 10 Aug 2026 15:06:45 GMT

← Older revision		Revision as of 15:06, 10 August 2026
Line 9:		Line 9:
	\|-		\|-
	\|edition		\|edition
	\|pro, farm, free		\|<code>pro</code>, <code>farm</code>, <code>free</code>
	\|-		\|-
	\|version		\|version
	\|e.g. 5.1, 5.4.3		\|e.g. <code>5.1</code>, <code>5.2.6</code>
	\|-		\|-
	\|service		\|service
	\|Services differ depending on edition and version. Common services are:		\|Services differ depending on edition and version. Common services are:
	wiki~~-task~~, proxy, cache, pdf, search, ~~formula,~~ diagram,...		<code>wiki</code>, <code>proxy</code>, <code>cache</code>, <code>pdf</code>, <code>search</code>, <code>diagram</code>, ...
	\|}		\|}
	First, pull the '''application image''' for the desired edition and version:<syntaxhighlight lang="bash">docker pull docker.bluespice.com/bluespice-$edition/wiki:$version</syntaxhighlight>Then, inspect the attachments with ORAS ([https://oras.land/docs/commands/oras_login/ oras requires login data]):<syntaxhighlight lang="bash">oras discover docker.bluespice.com/bluespice-$edition/wiki:$version</syntaxhighlight>Do the same for '''service images''':<br />Pull the image:<syntaxhighlight lang="bash">docker pull docker.bluespice.com/bluespice/$service:$version</syntaxhighlight>Inspect the attachments:<syntaxhighlight lang="bash">oras discover docker.bluespice.com/bluespice/$service:$version</syntaxhighlight>

	Example:<syntaxhighlight lang="shell-session">		=== Main application image ===
			Pull the '''application image''' for the desired edition and version:
			<syntaxhighlight lang="bash">docker pull docker.bluespice.com/bluespice-$edition/wiki:$version</syntaxhighlight>

			Inspect the attachments with ORAS ([https://oras.land/docs/commands/oras_login/ oras requires login data]):
			<syntaxhighlight lang="bash">oras discover docker.bluespice.com/bluespice-$edition/wiki:$version</syntaxhighlight>

			Example output:
			<syntaxhighlight lang="shell-session">
	> oras discover docker.bluespice.com/bluespice-farm/wiki:5.2.6		> oras discover docker.bluespice.com/bluespice-farm/wiki:5.2.6
	docker.bluespice.com/bluespice-farm/wiki@sha256:c683b74003ebedf40f0aa6c66fe858619dcbb036eeb191d3afc4385c3779260b		docker.bluespice.com/bluespice-farm/wiki@sha256:c683b74003ebedf40f0aa6c66fe858619dcbb036eeb191d3afc4385c3779260b
Line 27:		Line 34:
	└── [annotations]		└── [annotations]
	└── org.opencontainers.image.created: "2026-08-03T15:18:42Z"		└── org.opencontainers.image.created: "2026-08-03T15:18:42Z"
			</syntaxhighlight>

			Download the attachments (provide the actual sha of the attachment, e.g. <code>3d7b0e...58</code> from the example):
			<syntaxhighlight lang="bash">
			oras pull docker.bluespice.com/bluespice-$edition/wiki@sha265'shaofattachements'
	</syntaxhighlight>		</syntaxhighlight>

			=== Companion service images ===
			Pull the image for the desired version:
			<syntaxhighlight lang="bash">docker pull docker.bluespice.com/bluespice/$service:$version</syntaxhighlight>

			Inspect the attachments:
			<syntaxhighlight lang="bash">oras discover docker.bluespice.com/bluespice/$service:$version</syntaxhighlight>

	Download the attachments (provide the actual sha of the attachment~~, e.g. <code>3d7b0e...58</code> from the example~~)~~:<syntaxhighlight lang="bash">~~		Download the attachments (provide the actual sha of the attachment)
	~~oras pull docker.bluespice.com/bluespice-$edition/wiki@sha265'shaofattachements'~~		<syntaxhighlight lang="bash">
	~~</syntaxhighlight>or for services:~~<syntaxhighlight lang="bash">
	oras pull docker.bluespice.com/bluespice/$service@sha265'shaofattachements'		oras pull docker.bluespice.com/bluespice/$service@sha265'shaofattachements'
	</syntaxhighlight>		</syntaxhighlight>

			=== Perform a security scan ===
	The ~~SBOM file is located in your current folder as~~ <code>sbom.json</code>.		The previous commands have created a <code>sbom.json</code> file in the local directory. You can now scan it. Below is a scanning example for <code>trivy</code>:
			<syntaxhighlight lang="bash">

	You can now scan ~~your SBOM files~~. Below is a scanning example for ~~Trivy~~:<syntaxhighlight lang="bash">
	docker run --rm \		docker run --rm \
	-v "$PWD:/work:ro" \		-v "$PWD:/work:ro" \

Pagedraft:BlueSpice 6

Margit.link-rodrigue — Mon, 10 Aug 2026 09:30:27 GMT

Setup:Release Notes

Margit.link-rodrigue — Mon, 10 Aug 2026 07:34:31 GMT

Show changes

Setup:Software Bill of Materials (SBOM)

Rvogel1 — Fri, 07 Aug 2026 14:12:27 GMT

← Older revision		Revision as of 14:12, 7 August 2026
(4 intermediate revisions by the same user not shown)
Line 18:		Line 18:
	wiki-task, proxy, cache, pdf, search, formula, diagram,...		wiki-task, proxy, cache, pdf, search, formula, diagram,...
	\|}		\|}
	First, pull the '''application image''' for the desired edition and version:<syntaxhighlight lang="bash">docker pull docker.bluespice.com/bluespice/$edition/wiki:$version</syntaxhighlight>Then, inspect the attachments with ORAS ([https://oras.land/docs/commands/oras_login/ oras requires login data]):<syntaxhighlight lang="bash">oras discover docker.bluespice.com/bluespice/$edition/wiki:$version</syntaxhighlight>Do the same for '''service images''':<br />Pull the image:<syntaxhighlight lang="bash">docker pull docker.bluespice.com/bluespice/$service:$version</syntaxhighlight>Inspect the attachments:<syntaxhighlight lang="bash">oras discover docker.bluespice.com/bluespice/$service:$version</syntaxhighlight>		First, pull the '''application image''' for the desired edition and version:<syntaxhighlight lang="bash">docker pull docker.bluespice.com/bluespice-$edition/wiki:$version</syntaxhighlight>Then, inspect the attachments with ORAS ([https://oras.land/docs/commands/oras_login/ oras requires login data]):<syntaxhighlight lang="bash">oras discover docker.bluespice.com/bluespice-$edition/wiki:$version</syntaxhighlight>Do the same for '''service images''':<br />Pull the image:<syntaxhighlight lang="bash">docker pull docker.bluespice.com/bluespice/$service:$version</syntaxhighlight>Inspect the attachments:<syntaxhighlight lang="bash">oras discover docker.bluespice.com/bluespice/$service:$version</syntaxhighlight>

			Example:<syntaxhighlight lang="shell-session">
			> oras discover docker.bluespice.com/bluespice-farm/wiki:5.2.6
			docker.bluespice.com/bluespice-farm/wiki@sha256:c683b74003ebedf40f0aa6c66fe858619dcbb036eeb191d3afc4385c3779260b
			└── application/vnd.cyclonedx+json
			└── sha256:3d7b0eca2caad4ac8a2f9e939186183722f43923ebdf6c07e38bb1fe58454058
			└── [annotations]
			└── org.opencontainers.image.created: "2026-08-03T15:18:42Z"

	Download the attachments (provide the actual sha~~-string~~):<syntaxhighlight lang="bash">		</syntaxhighlight>
	oras pull docker.bluespice.com/bluespice/$edition/wiki@sha265'shaofattachements'


			Download the attachments (provide the actual sha of the attachment, e.g. <code>3d7b0e...58</code> from the example):<syntaxhighlight lang="bash">
			oras pull docker.bluespice.com/bluespice-$edition/wiki@sha265'shaofattachements'
	</syntaxhighlight>or for services:<syntaxhighlight lang="bash">		</syntaxhighlight>or for services:<syntaxhighlight lang="bash">
	oras pull docker.bluespice.com/bluespice/$service@sha265'shaofattachements'		oras pull docker.bluespice.com/bluespice/$service@sha265'shaofattachements'
Line 32:		Line 43:

	You can now scan your SBOM files. Below is a scanning example for Trivy:<syntaxhighlight lang="bash">		You can now scan your SBOM files. Below is a scanning example for Trivy:<syntaxhighlight lang="bash">
	docker run --rm \ -v "$PWD:/work:ro" \ aquasec/trivy~~:0.72.0~~ \ sbom \ --severity CRITICAL \ --ignore-unfixed \ --exit-code 1 \ /work/sbom.json		docker run --rm \
			-v "$PWD:/work:ro" \
			aquasec/trivy \
			sbom \
			--severity CRITICAL \
			--ignore-unfixed \
			--exit-code 1 \
			/work/sbom.json
	</syntaxhighlight>		</syntaxhighlight>

	[[de:Setup:Software_Bill_of_Materials_(SBOM)]]		[[de:Setup:Software_Bill_of_Materials_(SBOM)]]

Manual:Extension/ChatIntegration

Margit.link-rodrigue — Fri, 07 Aug 2026 13:12:13 GMT

← Older revision		Revision as of 13:12, 7 August 2026
(One intermediate revision by the same user not shown)
Line 1:		Line 1:
	{{DISPLAYTITLE:Chat integration (MS Teams, RocketChat, Slack)}}		{{DISPLAYTITLE:Chat integration (MS Teams, RocketChat, Slack)}}
	{{BSVersion\|bsvFrom=5.2\|bsvFeature=ChatIntegration\|info=This extension has [[Reference:ChatIntegration\|multiple prerequesites]] before it is available to users in a wiki.}}		{{BSVersion\|bsvFrom=5.2\|bsvFeature=ChatIntegration\|info=This extension has [[Reference:ChatIntegration#Setting_up_an_MS_Teams_Bot\|multiple prerequesites]] before it is available to users in a wiki.}}

	== Overview ==		== Overview ==
Line 8:		Line 8:
	* RocketChat		* RocketChat
	* Slack		* Slack
			{{Textbox\|boxtype=note\|header=Technical integration:\|text=If you do not see the BlueSpice chatbot in any of these applications, your wiki does not have the chat integration available yet. Talk to your administrator for help.\|icon=yes}}
	If you do not see the ''BlueSpice chatbot'' in any of these applications, your wiki does not have the chat integration available yet.

	== Adding your chat client username to the wiki ==		== Adding your chat client username to the wiki ==

Reference:ChatIntegration

Margit.link-rodrigue — Fri, 07 Aug 2026 13:10:36 GMT

← Older revision		Revision as of 13:10, 7 August 2026
(One intermediate revision by the same user not shown)
Line 8:		Line 8:
	\|category=Communication		\|category=Communication
	\|bsvFrom=5.2		\|bsvFrom=5.2
	\|~~active~~=~~Yes~~		\|features=
	~~\|license=GPL v3 only~~
	}}		}}
	~~{{wcagCheck}}~~		== Setting up an MS Teams Bot ==
			To create a MS Teams chat, the following steps are required:

			# Make the <code>TEAMS_WEB_PORT</code> (<code>8090</code> by default) of <code>bluespice/chat</code> available to the public internet with a valid SSL certificate. To achieve this, it might be necessary to set up a proxy (e.g. <code><nowiki>https://msteams.wiki.company.com</nowiki></code> → <code><nowiki>http://internalwikiserver:8090</nowiki></code>).
			# Create an "[https://portal.azure.com/#view/Microsoft_Azure_Marketplace/MarketplaceOffersBlade/searchQuery/azure%20bot/searchInitiatedFrom/plusNewBladeSearchContext/selectedMenuItemId/home/source~/%7B%22referrer%22%3A%22PlusNew.ReactView%22%2C%22controlName%22%3A%22Suggestions%22%2C%22controlType%22%3A%22SearchTermTyped%22%7D Azure Bot]" in the Azure Portal. A valid Azure Subscription, Application (ID is required) and Resource Group is required.
			## Set the public message endpoint to <code>/api/messages</code>. E.g.<code><nowiki>https://msteams.wiki.company.com/api/messages</nowiki></code>.
			## Enable the "MS Teams" channel.
			# Create a Client Secret in the [https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade registered apps list]. This must be done in the "Credentials" area: <code><nowiki>https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/~/Credentials/appId/</nowiki><APP-ID>/isMSAApp~/false</code>
			# Start <code>bluespice/chat</code> with the proper <code>TEAMS_</code> settings (Esp. "App-ID" and "Client-Secret")
			# Create an "MS Teams App".
			## Set the proper "App-ID" in the <code>[https://gitlab.hallowelt.com/BlueSpice/webservice-chat/-/blob/5ba9cac79c97c85c6818efd07659333c00ce8072/doc/ms-teams/manifest.json#L39 manifest.json]</code> and use the <code>[https://gitlab.hallowelt.com/BlueSpice/webservice-chat/-/blob/master/doc/ms-teams/createZip.sh?ref_type=heads createZIP.sh]</code> to forge the final app.
			# Install the "MS Teams App" through the [https://admin.teams.microsoft.com/policies/manage-apps MS Teams Admin Portal].
			## Make sure to confirm the required permissions.
			## Make sure to allow users to enable it.

			See also the original documentation at https://github.com/hubot-friends/hubot-ms-teams/blob/v3.0.0/README.md#going-live-set-up-instructions

Manual:Extension/ChatIntegration

Margit.link-rodrigue — Fri, 07 Aug 2026 13:05:28 GMT

← Older revision		Revision as of 13:05, 7 August 2026
Line 1:		Line 1:
	{{DISPLAYTITLE:Chat integration (MS Teams, RocketChat, Slack)}}		{{DISPLAYTITLE:Chat integration (MS Teams, RocketChat, Slack)}}
	{{BSVersion\|bsvFrom=5.2\|bsvFeature=ChatIntegration\|info=This extension has multiple prerequesites before it is available to users in a wiki.}}		{{BSVersion\|bsvFrom=5.2\|bsvFeature=ChatIntegration\|info=This extension has [[Reference:ChatIntegration\|multiple prerequesites]] before it is available to users in a wiki.}}

	== Overview ==		== Overview ==

Pagedraft:BlueSpice 6

Margit.link-rodrigue — Thu, 06 Aug 2026 13:54:12 GMT

Pagedraft:Reference:PageLayouts

Margit.link-rodrigue — Thu, 06 Aug 2026 13:53:26 GMT

Created page with "{{BSExtensionInfo |removed=No |status=stable |developer=HalloWelt |type=BlueSpice |edition=BlueSpice free, BlueSpice pro, BlueSpice farm, BlueSpice cloud |compatible=BlueSpice |category=Rich Articles |bsvFrom=6.0 |active=Yes |license=GPL v3 only }} {{wcagCheck}}"