certmonger-scep-submit(8)
NAME
scep-submit
SYNOPSIS
scep-submit -u SERVER-URL [-r ra-cert-file] [-R ca-cert-file] [-I other-certs-file] [-i ca-identifier] [-v] [-n] [-c|-C|-g|-p] [pkimessage-filename]
DESCRIPTION
scep-submit is the helper which certmonger can use to transmit certificate enrollment and renewal requests to servers using SCEP. It is not normally run interactively, but it can be for troubleshooting purposes. The request which is to be submitted should be a PEM-encoded SCEP pkiMessage either in a file whose name is given as an argument, or fed into scep-submit via stdin.
MODES
-c scep-submit will issue a GetCACaps request to the server and
print the results.
-C scep-submit will issue GetCACert and GetCAChain requests to the
server, parse the responses, and then print, in order, the RA
certificate, the CA certificate, and any additional
certificates.
-p scep-submit will issue a PKIOperation request to the server
using the passed-in message as the message content. It will
parse the server's response, verify the signature, and if the
response includes an issued certificate, it will output the
pkcsPKIEnvelope in PEM format. If the response indicates an
error, it will print the error.
-g scep-submit will issue a PKIOperation request to the server
using the passed-in message as the message content. It will
parse the server's response, verify the signature, and if the
response includes an issued certificate, it will output the
pkcsPKIEnvelope in PEM format. If the response indicates an
error, it will print the error.
OPTIONS
-u SERVER-URL
The location of the SCEP interface provided by the CA. This is
typically http://SERVER/cgi-bin/PKICLIENT.EXE or
http://SERVER/certsrv/mscep/mscep.dll. This option is always
required.
-R CA-certificate-file
The location of the SCEP server's CA certificate, which was used
to issue the SCEP server's certificate, or the SCEP server's own
certificate, if it is self-signed, in PEM form. If the URL
specified with the -u option is an https URL, then this option
is required.
-r RA-certificate-file
The location of the SCEP server's RA certificate, which is
expected to be used for signing responses sent by the SCEP
server back to the client. This option is required when either
the -g flag or the -p flag is specified.
-I other-certificates-file
The location of a file containing other PEM-formatted
certificates which may be needed in order to properly verify
signed responses sent by the SCEP server back to the client.
This option may be necessary when either the -g flag or the -p
flag is specified.
-i ca-identifier
When called with the -c or -C flag, this option can be used to
specify the CA identifier which is passed to the server as part
of the client's request. The default is "0".
-n The SCEP Renewal feature allows a client with a previously-
issued certificate to use that certificate and the associated
private key to request a new certificate for a different key
pair, and can be used to support certmonger's rekeying feature
if the SCEP server advertises support for it. This option
forces the scep-submit helper to prefer to issue requests which
do not make use of this feature.
-v Increases the logging level. Use twice for more logging. This
option is mainly useful for troubleshooting.
EXIT STATUS
0 if the certificate was issued. The pkcsPKIEnvelope will be
printed in PEM-encoded form.
1 if the CA is still thinking. A cookie (state) value will be
printed.
2 if the CA rejected the request. An error message may be
printed.
3 if the CA was unreachable. An error message may be printed.
4 if critical configuration information is missing. An error
message may be printed.
5 if the CA is still thinking. A suggested poll delay (specified
in seconds) and a cookie (state) value will be printed.
16 if the helper needs an SCEP pkiMessage, but couldn't read one.
17 if the CA indicates that the client needs to attempt enrollment
using a new key pair.
BUGS
Please file tickets for any that you find at https://fedorahosted.org/certmonger/
SEE ALSO
certmonger(8) getcert(1) getcert-add-ca(1) getcert-add-scep-ca(1) getcert-list-cas(1) getcert-list(1) getcert-modify-ca(1) getcert- refresh-ca(1) getcert-remove-ca(1) getcert-resubmit(1) getcert-start- tracking(1) getcert-status(1) getcert-stop-tracking(1) certmonger- certmaster-submit(8) certmonger-dogtag-ipa-renew-agent-submit(8) certmonger-dogtag-submit(8) certmonger-ipa-submit(8) certmonger-local- submit(8) certmonger_selinux(8)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
