Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

remove central gateway reference from the docs for v3 #4038

Merged
merged 17 commits into from
Dec 20, 2024
Merged

remove central gateway reference from the docs for v3 #4038

Show file tree
Hide file tree
Changes from 8 commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
36c7985
remove the central from trouble shooting
Shobhajayanna Dec 13, 2024
5cd2950
Update troubleshoot-apiml-error-codes.md
Shobhajayanna Dec 16, 2024
0fddd81
removing central gateway reference from the zowe docs
Shobhajayanna Dec 17, 2024
4771386
Update api-mediation-multi-tenancy.md
Shobhajayanna Dec 17, 2024
ef562fc
minor language fix
janan07 Dec 18, 2024
75cb1e0
Update api-mediation-multi-tenancy.md
Shobhajayanna Dec 18, 2024
36ffb0e
address review comments
Shobhajayanna Dec 18, 2024
a68dbc5
refactor
Shobhajayanna Dec 18, 2024
02d33cf
refactor
Shobhajayanna Dec 18, 2024
195d970
refactor
Shobhajayanna Dec 18, 2024
0442861
address comments
Shobhajayanna Dec 18, 2024
6a687a8
Update docs/user-guide/api-mediation/api-mediation-multi-tenancy.md
Shobhajayanna Dec 19, 2024
e1feb2b
Update versioned_docs/version-v2.18.x/whats-new/zowe-v3-frequently-as…
Shobhajayanna Dec 19, 2024
68a19e3
updated the document
Shobhajayanna Dec 19, 2024
7f9035d
Update api-mediation-multi-tenancy.md
Shobhajayanna Dec 19, 2024
9b98a09
address comments
Shobhajayanna Dec 19, 2024
4dfc29b
address review comments
Shobhajayanna Dec 19, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 10 additions & 22 deletions docs/troubleshoot/troubleshoot-apiml-error-codes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -531,43 +531,43 @@ The following error message codes may appear on logs or API responses. Use the f

### ZWEAT500E

Failed to parse the client certificate forwarded from the central Gateway. Error message %s. The client certificate was %s
Failed to parse the client certificate forwarded from the Gateway. Hostname is %s. Error message is %s. The client certificate was %s

**Reason:**

The string sent by the central Gateway was not recognized as a valid DER-encoded certificate in the Base64 printable form.
The string sent by the Gateway was not recognized as a valid DER-encoded certificate in the Base64 printable form.

**Action:**

Ensure that forwarding of the client certificate is also enabled in the central Gateway. Check for any error messages from the central Gateway.
Ensure that forwarding of the client certificate is also enabled in the Gateway. Check for any error messages from the Gateway.

### ZWEAT501E

Failed to get trusted certificates from the central Gateway. Unexpected response from %s endpoint. Status code: %s. Response body: %s
Failed to get trusted certificates from the Gateway. Unexpected response from %s endpoint. Status code: %s. Response body: %s

**Reason:**

The response status code is different from the expected 200 OK.

**Action:**

Ensure that the parameter apiml.security.x509.certificatesUrls is correctly configured with the complete URL to the central Gateway certificates endpoint. Test the URL manually.
Ensure that the parameter apiml.security.x509.certificatesUrls is correctly configured with the complete URL to the Gateway certificates endpoint. Test the URL manually.

### ZWEAT502E

Invalid URL specified to get trusted certificates from the central Gateway. Error message: %s
Invalid URL specified to get trusted certificates from the Gateway. URL is %s. Error message: %s

**Reason:**

The parameter apiml.security.x509.certificatesUrls is not correctly configured with the complete URL to the central Gateway certificates endpoint.
The parameter apiml.security.x509.certificatesUrls is not correctly configured with the complete URL to the Gateway certificates endpoint.

**Action:**

Ensure that the parameter apiml.security.x509.certificatesUrls is correctly configured.

### ZWEAT503E

An error occurred during retrieval of trusted certificates from the central Gateway. Error message: %s
An error occurred during retrieval of trusted certificates from the Gateway. Certificate endpoint is %s. Error message: %s

**Reason:**

Expand All @@ -579,28 +579,16 @@ The following error message codes may appear on logs or API responses. Use the f

### ZWEAT504E

Failed to parse the trusted certificates provided by the central Gateway. Error message %s
Failed to parse the trusted certificates provided by the Gateway. Certificate endpoint is %s. Error message %s

**Reason:**

The string sent by the central Gateway was not recognized as valid DER-encoded certificates in the Base64 printable form.
The string sent by the Gateway was not recognized as valid DER-encoded certificates in the Base64 printable form.

**Action:**

Check that the URL configured in apiml.security.x509.certificatesUrls responds with valid DER-encoded certificates in the Base64 printable form.

### ZWEAT505E

Incoming request certificate is not one of the trusted certificates provided by the central Gateway.

**Reason:**

The Gateway performs an additional check of request certificates when the central Gateway forwards the incoming client certificate to the domain Gateway. This check may fail when the certificatesUrl parameter does not point to the proper central Gateway certificates endpoint.

**Action:**

Check that the URL configured in apiml.security.x509.certificatesUrls points to the central Gateway and it responds with valid DER-encoded certificates in the Base64 printable form.

### ZWEAT601E

z/OSMF service name not found. Set parameter apiml.security.auth.zosmf.serviceId to your service ID.
Expand Down
Loading
Loading