/* * Copyright 2016 Red Hat, Inc. and/or its affiliates * and other contributors as indicated by the @author tags. * * 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 * * http://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. */ package org.keycloak.client.registration.cli.commands; import org.jboss.aesh.cl.Arguments; import org.jboss.aesh.cl.CommandDefinition; import org.jboss.aesh.cl.Option; import org.jboss.aesh.console.command.CommandException; import org.jboss.aesh.console.command.CommandResult; import org.jboss.aesh.console.command.invocation.CommandInvocation; import org.keycloak.client.registration.cli.config.ConfigData; import org.keycloak.client.registration.cli.common.EndpointType; import org.keycloak.client.registration.cli.util.ParseUtil; import org.keycloak.representations.adapters.config.AdapterConfig; import org.keycloak.representations.idm.ClientRepresentation; import org.keycloak.representations.oidc.OIDCClientRepresentation; import org.keycloak.util.JsonSerialization; import java.io.IOException; import java.io.InputStream; import java.io.PrintWriter; import java.io.StringWriter; import java.util.List; import static org.keycloak.client.registration.cli.util.AuthUtil.ensureToken; import static org.keycloak.client.registration.cli.util.ConfigUtil.DEFAULT_CONFIG_FILE_STRING; import static org.keycloak.client.registration.cli.util.ConfigUtil.credentialsAvailable; import static org.keycloak.client.registration.cli.util.ConfigUtil.getRegistrationToken; import static org.keycloak.client.registration.cli.util.ConfigUtil.loadConfig; import static org.keycloak.client.registration.cli.util.ConfigUtil.saveMergeConfig; import static org.keycloak.client.registration.cli.util.ConfigUtil.setRegistrationToken; import static org.keycloak.client.registration.cli.util.HttpUtil.APPLICATION_JSON; import static org.keycloak.client.registration.cli.util.HttpUtil.doGet; import static org.keycloak.client.registration.cli.util.HttpUtil.urlencode; import static org.keycloak.client.registration.cli.util.IoUtil.warnfErr; import static org.keycloak.client.registration.cli.util.IoUtil.printOut; import static org.keycloak.client.registration.cli.util.IoUtil.readFully; import static org.keycloak.client.registration.cli.util.OsUtil.CMD; import static org.keycloak.client.registration.cli.util.OsUtil.EOL; import static org.keycloak.client.registration.cli.util.OsUtil.PROMPT; /** * @author <a href="mailto:mstrukel@redhat.com">Marko Strukelj</a> */ @CommandDefinition(name = "get", description = "[ARGUMENTS]") public class GetCmd extends AbstractAuthOptionsCmd { @Option(shortName = 'c', name = "compressed", description = "Print full stack trace when exiting with error", hasValue = false) private boolean compressed = false; @Option(shortName = 'e', name = "endpoint", description = "Endpoint type to use", hasValue = true) private String endpoint; @Arguments private List<String> args; @Override public CommandResult execute(CommandInvocation commandInvocation) throws CommandException, InterruptedException { try { if (printHelp()) { return help ? CommandResult.SUCCESS : CommandResult.FAILURE; } processGlobalOptions(); if (args == null || args.isEmpty()) { throw new IllegalArgumentException("CLIENT not specified"); } if (args.size() > 1) { throw new IllegalArgumentException("Invalid option: " + args.get(1)); } String clientId = args.get(0); EndpointType regType = endpoint != null ? EndpointType.of(endpoint) : EndpointType.DEFAULT; if (clientId.startsWith("-")) { warnfErr(ParseUtil.CLIENT_OPTION_WARN, clientId); } ConfigData config = loadConfig(); config = copyWithServerInfo(config); if (token == null) { // if registration access token is not set via -t, try use the one from configuration token = getRegistrationToken(config.sessionRealmConfigData(), clientId); } setupTruststore(config, commandInvocation); String auth = token; if (auth == null) { config = ensureAuthInfo(config, commandInvocation); config = copyWithServerInfo(config); if (credentialsAvailable(config)) { auth = ensureToken(config); } } auth = auth != null ? "Bearer " + auth : null; final String server = config.getServerUrl(); final String realm = config.getRealm(); InputStream response = doGet(server + "/realms/" + realm + "/clients-registrations/" + regType.getEndpoint() + "/" + urlencode(clientId), APPLICATION_JSON, auth); try { String json = readFully(response); Object result = null; switch (regType) { case DEFAULT: { ClientRepresentation client = JsonSerialization.readValue(json, ClientRepresentation.class); result = client; saveMergeConfig(cfg -> { setRegistrationToken(cfg.ensureRealmConfigData(server, realm), client.getClientId(), client.getRegistrationAccessToken()); }); break; } case OIDC: { OIDCClientRepresentation client = JsonSerialization.readValue(json, OIDCClientRepresentation.class); result = client; saveMergeConfig(cfg -> { setRegistrationToken(cfg.ensureRealmConfigData(server, realm), client.getClientId(), client.getRegistrationAccessToken()); }); break; } case INSTALL: { result = JsonSerialization.readValue(json, AdapterConfig.class); break; } case SAML2: { break; } default: { throw new RuntimeException("Unexpected type: " + regType); } } if (!compressed && result != null) { json = JsonSerialization.writeValueAsPrettyString(result); } printOut(json); //} catch (UnrecognizedPropertyException e) { // throw new RuntimeException("Failed to parse returned JSON - " + e.getMessage(), e); } catch (IOException e) { throw new RuntimeException("Failed to process HTTP response", e); } return CommandResult.SUCCESS; } catch (IllegalArgumentException e) { throw new IllegalArgumentException(e.getMessage() + suggestHelp(), e); } finally { commandInvocation.stop(); } } @Override protected boolean nothingToDo() { return noOptions() && endpoint == null && (args == null || args.size() == 0); } protected String suggestHelp() { return EOL + "Try '" + CMD + " help get' for more information"; } protected String help() { return usage(); } public static String usage() { StringWriter sb = new StringWriter(); PrintWriter out = new PrintWriter(sb); out.println("Usage: " + CMD + " get CLIENT [ARGUMENTS]"); out.println(); out.println("Command to retrieve a client configuration description for a specified client. If registration access token"); out.println("is specified or is available in configuration file, then it is used. Otherwise, current active session is used."); out.println(); out.println("Arguments:"); out.println(); out.println(" Global options:"); out.println(" -x Print full stack trace when exiting with error"); out.println(" --config Path to the config file (" + DEFAULT_CONFIG_FILE_STRING + " by default)"); out.println(" --truststore PATH Path to a truststore containing trusted certificates"); out.println(" --trustpass PASSWORD Truststore password (prompted for if not specified and --truststore is used)"); out.println(" -t, --token TOKEN Registration access token to use"); out.println(" CREDENTIALS OPTIONS Same set of options as accepted by '" + CMD + " config credentials' in order to establish"); out.println(" an authenticated sessions. This allows on-the-fly transient authentication that does"); out.println(" not touch a config file."); out.println(); out.println(" Command specific options:"); out.println(" CLIENT ClientId of the client to display"); out.println(" -c, --compressed Don't pretty print the output"); out.println(" -e, --endpoint TYPE Endpoint type to use - one of: 'default', 'oidc', 'install'"); out.println(); out.println("Examples:"); out.println(); out.println("Get configuration in default format:"); out.println(" " + PROMPT + " " + CMD + " get my_client"); out.println(); out.println("Get configuration in OIDC format:"); out.println(" " + PROMPT + " " + CMD + " get my_client -e oidc"); out.println(); out.println("Get adapter configuration for the client:"); out.println(" " + PROMPT + " " + CMD + " get my_client -e install"); out.println(); out.println(); out.println("Use '" + CMD + " help' for general information and a list of commands"); return sb.toString(); } }