About • Installation • Development • Support • Contribute • Contributors • Licensing
The DGC-CLI provides a toolchain for manually interacting with DGC Components. This list gives an overview of the possibilities. For detailed information use the built-in help.
- Signing
- Envelope a Certificate in signed CMS message (for DGC Gateway upload)
- Verify enveloped certificate in signed CMS message
- TrustAnchor
- Sign a certificate with a TrustAnchor for usage in DGC Gateway
You need to have a JRE (minimum version 11) installed on your system. Also the java executable should be available in your PATH variable.
- Download latest build from Releases
- Extract ZIP-File to a path of your choice
- Add the Path to your PATH variable
- Check your installation
dgc --version
Whether you cloned or downloaded the 'zipped' sources you will either find the sources in the chosen checkout-directory or get a zip file with the source code, which you can expand to a folder of your choice.
In either case open a terminal pointing to the directory you put the sources in. The local build process is described afterwards depending on the way you choose.
- OpenJDK 11 (with installed
keytool
CLI) - Maven
- Authenticate to Github Packages
As some of the required libraries (and/or versions are pinned/available only from GitHub Packages) You need to authenticate to GitHub Packages The following steps need to be followed
- Create PAT with scopes:
read:packages
for downloading packages
- Copy/Augment
~/.m2/settings.xml
with the contents ofsettings.xml
present in this repository- Replace
${app.packages.username}
with your github username - Replace
${app.packages.password}
with the generated PAT
- Replace
Building this project is done with maven.
mvnw install
Will download all required dependencies, build the project and stores the artifact in your local repository.
The following channels are available for discussions, feedback, and support requests:
Type | Channel |
---|---|
Gateway issues | |
CLI issues | |
DGC Lib issues | |
Other requests |
Contribution and feedback is encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines. By participating in this project, you agree to abide by its Code of Conduct at all times.
Our commitment to open source means that we are enabling -in fact encouraging- all interested parties to contribute and become part of its developer community.
Copyright (C) 2021 T-Systems International GmbH and all other contributors
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the LICENSE for the specific language governing permissions and limitations under the License.