Download the PHP package nunar/halcom without Composer
On this page you can find all versions of the php package nunar/halcom. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package halcom
One For All Web Service (by Halcom)
Disclaimer: The presentation text below is taken from the official website.
One For All Web Service enables the e-business applications to be independent from specific agencies, who issue digital certificates. The web service supports the certificates of all Slovenian certificate agencies: SIGEN-CA, SIGOV-CA, ACNLB, POŠTA®CA and HALCOM-CA. Certain functionalities of the web service are not supported for some special certificates issued by these agencies.
More information about this web service:
- Halcom.si
- Technical documentation (sorry, only in Slovenian)
Target users
Halcom’s web services for facilitating electronic business are intended for various electronic services providers that want to enable their users access to services using digital certificates of all registered certificate authorities in Slovenia, but do not want to deal with different ways registration authorities save data into digital certificates.
Accessing and using these web services
The use of these web services is free of charge, but not anonymous. You can request access to web services here. After your request is placed, you will receive an email from [email protected] and then send them your clients’ (public) digital certificate.
Installation
To install nunar/halcom just require it with composer
Examples of usage
More information about how the web services work, as well as example of requests and responses are available in the technical documentation.
Firstly, we have to save certificate (in PEM format) to variable, e.g. $cert
. All examples are based on cert.pem.
Initialization
For its operation, the web service requires the client's digital certificate.
Web service WSDL file is available on the domain https://ws.halcom.si which uses a certificate issued by Halcom CA PO 2. In most cases Halcom CA PO 2 is not in CA store, so you have to add it or disable peer verification and allow self-signed certificates:
If you are using Laravel you can set this in .env
CertificateInfo Web Service
CertificateInfo Web Service is a web service for returning information about the digital certificate and its holder.
Request
The CertificateInfo Web Service supports the certificates of all Slovenian certificate agencies, but the amount of information in the response depends on the certificate agency.
For all certificate agencies, the response will contain:
- issuer's common name (e.g. SIGEN-CA, SIGOV-CA, ACNLB, POŠTArCA, Halcom CA PO or Halcom CA PO 2),
- certificate serial number,
- period of certificate validity (from, to),
- the certificate holder's first and last name or common name,
- company mentioned in the certificate (for certificates held by the representatives of legal entities).
This web service will return a company tax number only when the certificate belongs to a company or a representative of a legel entity.
The holder's tax number will be returned only for certificates issued by ACNLB or POŠTA®CA.
Company ID will be returned only for certificates issued by HALCOM-CA.
Response
CertificateStatus Web Service
CertificateStatus Web Service is a web service for verifying the validity of digital certificates:
- period of validity,
- validity of the signature on the certificate,
- certificate status on the list of revoked certificates.
Request
Response
CertificateTaxNumbers Web Service
CertificateTaxNumbers Web Service is a web service for verifying tax numbers of digital certificates (holder tax number or company tax number).
The certificates held by representatives of legal entities and issued by the certificate agency SIGEN-CA or SIGOV-CA don't include personal or employees' tax numbers, so the tax number verification is only possible for certificates from these agencies: ACNLB, POŠTA®CA and HALCOM-CA.
Request
Response
It's also possible to verify only holder tax number or only company tax number:
In this case response status for companyTaxNumberStatus
or taxNumberStatus
will be 701.
All versions of halcom with dependencies
ext-soap Version *